home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / npf221e.zip / NPF221E.EXE / NPFPMS.DAT / NOTES.DOC < prev    next >
Text File  |  1994-07-09  |  104KB  |  2,428 lines
  1. NPFPMS  Multi-User PMS  (C) G8NPF 1994
  2.  
  3. A collection of notes about NPFPMS
  4. -------------------------------------------------------------------------------
  5.  
  6. When editing the npfpms.cfg file or any of the CONFIG or SCRIPT files, use an
  7. ASCII editor. Beware of WP programs (like WordStar?) which can leave odd
  8. formatting control codes in the text!
  9.  
  10. *NEVER* manually edit the files in the SYS sub-directory. They may not be ascii
  11. files, even if they may appear to be!  The only exception is the BBS.NAC file
  12. which you may update, provided the same layout is retained.
  13.  
  14. *NEVER* manually delete any files in the MAIL or SYS sub-directories.
  15.  
  16. Files in the SCRIPT and CONFIG sub-directories are ascii files and can be
  17. edited as required.
  18.  
  19. Do NOT set the Read-only, Hidden or System attributes on any of the files used
  20. by the PMS.
  21.  
  22. Note: The clock in the PC should be set to match the TIMESIG entry.
  23. (Times in Amateur Radio are normally in GMT)
  24.  
  25. With slower PC's (and/or hard drives), installing MSDOS's FASTOPEN in your
  26. config.sys file may speed up PMS functions which do a lot of disk searching.
  27. (Like forwarding)
  28.  
  29. The PMS can open quite a few files at times. BPQcode may also have open files,
  30. so make sure your DOS is configured with sufficient files, especially if you
  31. are running the PMS under DESQview, or you are running other programs that open
  32. lots of files.
  33.  
  34. The PMS is in full colour, but *should* be ok on a mono vdu with MDA or
  35. Hercules card.
  36.  
  37. -------------------------------------------------------------------------------
  38. After installation, the main PMS directory will contain the following files and
  39. sub-directories.
  40. PMS.BAT
  41. PMSCODE.EXE
  42. PMSCODE.DLL
  43. RENUMBER.EXE
  44. DELUSER.EXE
  45. PASSWORD.EXE
  46. PRUNIDX.EXE
  47. 7PLUS      <DIR>
  48. ARCHIVE    <DIR>
  49. CONFIG     <DIR>
  50. FILES      <DIR>
  51. FILES.ULD  <DIR>
  52. MAIL       <DIR>
  53. SCRIPT     <DIR>
  54. SYS        <DIR>
  55.  
  56. The CONFIG sub-directory may contain the following files. (Some are optional)
  57. AUTOLIST.CMD
  58. CHANGE.BBS
  59. DUPCHECK.LST
  60. EXTERNAL.BAT
  61. FILEDESC.TXT
  62. FWDFILE.LST
  63. HOLD.LST
  64. NPFPMS.CFG
  65. PASSWORD.FBB            Passwords for use with FBB systems.
  66. xxxxxx.MAT              Password matrix file(s) for NNA/NPF systems.
  67.  
  68. The SCRIPT sub-directory may contain the following files.
  69. ALLMSG.TXT
  70. FILES.TXT
  71. HELP.TXT
  72. INFO.TXT
  73. INTRO.TXT
  74. NONREG.TXT
  75. NONXMSG.TXT
  76.  
  77. The SYS sub-directory MUST contain the following files.
  78. BBS.NAC
  79. LZHRLL.COM
  80. NXTMSG.NUM
  81. SYSOP.TXT
  82.  
  83. After running for a while, the PMS may create the following files in the SYS
  84. sub-directory.
  85. %LOG.PMS
  86. ATBBS.LST
  87. AUTOLISTA.PMS
  88. AUTOLISTB.PMS
  89. BIDS.REC
  90. JALIST.LST
  91. MSGINDEX.IDX
  92. NAMELOG.SYS
  93. Some other files starting with a % may be created. Never interfere with them!
  94. Some temporary files with the extension .$$$ will also be created, and will be
  95. automatically deleted.
  96.  
  97. The FILES sub-directory must contain the file USER.DOC
  98. Unless you have specified an alternative directory for downloadable files, you
  99. should also place any files you wish to make available for downloading in this
  100. directory. Filenames must contain at least one non-numeric character.
  101. i.e.  123.doc 123list.001 and 123.001 are all ok, but not just 123
  102. The FILES sub-directory may also contain further sub-directories.
  103.  
  104. User uploaded files go into the FILES.ULD sub-directory, (or whatever 
  105. alternative directory you have specified) and are not available to other users
  106. until they are transferred into the download directory by the SysOp. When a
  107. file is uploaded, the system creates a .dsc file in the upload directory, which
  108. contains information on the uploaded file. DO NOT ALTER THESE .DSC FILES!
  109.  
  110. You may specify alternative drives/directories for upload and download files.
  111.  
  112. -------------------------------------------------------------------------------
  113. To run the PMS type:   PMS (/switch)
  114. The command line accepts the following switches:
  115.  
  116. /H  Lists the valid switches.
  117. /D  Inhibit the check for the DOS version.
  118. /P  Inhibit Printer-on-line check.
  119. /Vx Inhibit DESQview calls.
  120.  
  121. The PMS requires MSDOS 3.30 (DRDOS 5.00) or later.
  122. DESQview (if used) should be version 2 or later.
  123. You can inhibit the DOS check if you know the PMS does run under your version
  124. of DOS, but the PMS initialisation file objects.
  125. Inhibiting the DV calls may slows things down if running under DV.
  126. Inhibiting the printer check, and then printing to an off-line or non-existent
  127. printer, may well 'hang' the system.
  128.  
  129. The system will load an existing JA list, or start a new list otherwise.
  130.  
  131. **** IMPORTANT!
  132. The very first time you run the PMS, enter your own Name/HomeBBS/QTH details
  133. (N NH NQ) and then do a 'B' (Bye) to enter your details into the user database.
  134. *** You must do this before any other person uses the PMS ***
  135.  
  136. To close down the PMS type EXIT from the command line. You cannot close the
  137. PMS if it is connected to a user (or node), or any screen is using the editor.
  138. Disconnect all users and close all editor screens first, and then enter the
  139. EXIT command.
  140.  
  141. -------------------------------------------------------------------------------
  142. Configuration file details.
  143.  
  144. Each entry must be contained on a single logical line. If a line ends in an
  145. underscore character _ the following line will be treated as an extension of
  146. the previous line.
  147.  
  148. Most entries are optional and can be put in any order. Undefined entries will
  149. default to pre-set values. A few entries MUST be specified. These are noted in
  150. the description.  (Any text is only for example).
  151. Comments following a semicolon ; will be ignored. Multiple spaces and <Tab>
  152. characters are reduced to a single space.
  153.  
  154. To include leading spaces, multiple spaces, or a ; character, in a text entry,
  155. enclose the entry in double or single quotes.
  156. e.g. "   Text entry"     'Text   entry'   "A semicolon ; in the string"
  157.  
  158. To include quotes in the entry, enclose it with quotes of the other type.
  159. e.g.  "This is 'quotes' in a string"  or  'This is "quotes" in a string'
  160.  
  161.  
  162. ACCEPT <list of callsign's>
  163. If an accept list is specified, then only the callsign's in the list will be
  164. able to connect to the PMS. All others will be rejected.
  165. The default is no list.
  166.  
  167. ACKENABLE YES/NO
  168. Determines whether the PMS automatically generates an acknowledgement reply
  169. when the last line of an incoming message is /ACK
  170. The default is YES
  171.  
  172. ARCHIVE <drv:\path>
  173. Alternative directory path for archived messages.
  174. The default is \PMS\ARCHIVE\
  175.  
  176. ARCOMPRESSED YES/NO
  177. Download 'AutoRead' messages from FBB BBS's in compressed format, if possible.
  178. The default is YES
  179.  
  180. AUDIO ON/OFF
  181. Determines if all audio (except the chat alarm) is on or off.
  182. The default is ON
  183.           
  184. AUTOLISTTIME-A HH:MM HH:MM (xx:MM) ....
  185. A list of times for a type A AutoList/Read of mail from the local NTSBBS.
  186. See the Mail Forwarding section for more details on how to set times.
  187. The default is no list.
  188.  
  189. AUTOLISTTIME-B HH:MM HH:MM (xx:MM) ....
  190. A list of times for a type B AutoRead of mail from the local NTSBBS.
  191. See the Mail Forwarding section for more details on how to set times.
  192. The default is no list.
  193.  
  194. AUTOPROMPT-A <prompt>
  195. The prompt received from the type A NTSBBS
  196. The default is a null.
  197.  
  198. AUTOPROMPT-B <prompt>
  199. The prompt received from the type B NTSBBS
  200. The default is a null.
  201.  
  202. AUTOREADCMD V/R
  203. The read command issued by the AutoRead function for non-FBB BBS's, or when
  204. the ARCOMPRESSED option is set to NO
  205. V = Verbose read, which includes all the routing information.
  206. R = Normal read.
  207. The Default is R
  208.  
  209. AUTOROUTE-A <route>
  210. The route to your type A NTSBBS
  211. The default is to connect direct to the BBS specified by the NTSBBS entry
  212.  
  213. AUTOROUTE-B <route>
  214. The route to your type B NTSBBS
  215. The default is to connect direct to the BBS specified by the NTSBBS entry
  216.  
  217. AUTOTYPE 0-2
  218. If 0, then a normal AutoList/Read sequence, without passwords, takes place.
  219. If 1, then the PMS will, upon connecting, send SYSOP (FBB) or @ (non-FBB) to
  220.       request a password verification. For use by a remote Sysop.
  221. If 2, then the PMS will send its full [SID] on connecting for AutoList.
  222. The default is 0. (Option 2 is reserved).
  223.  
  224. BLANK <minutes>
  225. Duration in minutes before the 'Screen Saver' blanks the screen.
  226. Set to 0 to disable the screen blanker.
  227. The default is 15 minutes.
  228.  
  229. BPQDIR <(drv:)\path>
  230. This specifies the full DOS pathway to the BPQ directory. 
  231. The BPQ directory MUST contain the file BPQCFG.BIN
  232. The default is \BPQ\
  233.  
  234. BTEXT <text>
  235. BPQ node beacon text. Sent at intervals by the BPQ node.
  236. The default is no text.
  237.  
  238. CHANNELS 0-14
  239. Specifies the number of user channels, from channel 0.
  240. CHANNELS 2 will give you channels 0, 1 and 2. The greater CHANNELS is set to,
  241. the slower some functions may be, and the more memory the system will require!
  242. The default is 2
  243.  
  244. DEFMASK &H0000-&H7FFF
  245. The startup value for the monitor port mask.
  246. The default is hex &H7FFF (All ports monitored for all types of frames)
  247.  
  248. DELETEBULLETIN <number of days>
  249. This is the number of days after which a bulletin is automatically deleted. A
  250. setting of 0 disables the function. Deleted messages cannot be recovered.
  251. The default is 30 (approx. one month). Valid range is 0 to 265
  252.  
  253. DELETEPERSONAL <number of days>
  254. This is the number of days after which a personal message is automatically
  255. deleted. A setting of 0 disables the function. Deleted messages cannot be
  256. recovered.
  257. The default is 60 (approx. two months). Valid range is 0 to 265
  258.  
  259. DIRECT ON/OFF
  260. Determines if the PMS writes directly to the screen memory, or uses the BIOS.
  261. Direct screen writes are faster, but if the PMS is running in a DV window
  262. (i.e. not full screen) under an older version of DesqView, it may write text
  263. outside its window. Later version of DV have an option to prevent this.
  264. Using the bios is safer, but can be slower. Some mono cards may not display
  265. inverted or flashing text correctly unless DIRECT is set to ON. 
  266. The default is OFF  (use the bios)
  267.  
  268. ERRORCOLOUR <colour>
  269. Colour of text for 'error' messages.
  270. The default is 12  (Light red)
  271.  
  272. EXT <string>
  273. The PMS SID banner.
  274. The default is all options valid [ABFLHMV$]
  275.  
  276. FILES <drv:\path>
  277. Alternative directory path for the download files area.
  278. The default is \PMS\FILES\
  279.  
  280. FWDTIME HH:MM HH:MM ....
  281. A list of times when the PMS will do automatic mail forwarding.
  282. See the "Setting of times" section for more details on how to set times.
  283. The default is no list.
  284.  
  285. FWDLEVEL 1/2
  286. If 1, then the PMS will only forward messages addressed FROM the PMS SysOp.
  287. If 2, then the PMS will forward messages from any callsign.
  288. The default is 1
  289.  
  290. FWDONTO YES/NO
  291. If YES, then forward messages on the TO field, as well as the @BBS field.
  292. If NO, then only forward messages on the @BBS field.
  293. The default is NO
  294.  
  295. HOSTPORT <host port number>
  296. This is the BPQ base host port to use for the PMS. Host ports can be from
  297. 1 to 64. If you specify base HOSTPORT 30, and CHANNELS 3 then the PMS will use
  298. host ports 30,31,32 and 33 for channels 0 to 3. The base host port specified
  299. must be less than (64-CHANNELS)
  300. The default is 30
  301.  
  302. INACTIVETIMEOUT <time in seconds>
  303. This is the maximum time the PMS will wait for ANY input while connected to a
  304. user.  This will stop the PMS 'hanging' if a user disappears without
  305. disconnecting.  1200 gives 20 minutes
  306. The default is 1200. Valid range is 60 to 1800
  307.  
  308. INSERTCOLOUR
  309. The default is 7 (white)
  310.  
  311. JALISTSIZE <size>
  312. The maximum number of entries allowed in the JA list.
  313. The default is 50. Valid range is 10 to 1000
  314.  
  315. KEEPBBSMSG YES/NO
  316. If YES then incomplete un-compressed messages from BBS stations will be kept.
  317. If NO they will be deleted. (Incomplete compressed messages are always deleted)
  318. The default is NO
  319.  
  320. KEEPFILE YES/NO
  321. If YES then incomplete uploaded ASCII files will be kept. If NO they will be
  322. deleted. (Incomplete binary files, uploaded by users, are always deleted)
  323. The default is NO
  324.  
  325. KEEPMSG YES/NO
  326. If YES then incomplete un-compressed messages from normal users will be kept.
  327. If NO they will be deleted. (Incomplete compressed messages are always deleted)
  328. The default is YES
  329.  
  330. KEYBOARDCOLOUR <colour>
  331. The Default is 7 (white)
  332.  
  333. KILLBULLETIN <number of days>
  334. This is the number of days after which a bulletin is automatically killed. A
  335. setting of 0 disables the function.
  336. The default is 15. Valid range is 0 to 265
  337.  
  338. KILLONFWD YES/NO
  339. If set to YES, then mail will be automatically killed after being forwarded.
  340. The default is NO
  341.  
  342. KILLONREAD YES/NO
  343. If set to YES, then you are offered the option to kill or delete the message
  344. you have just read.  Only available to the SysOp (or a remote SysOp).
  345. The default is NO
  346.  
  347. KILLPERSONAL <number of days>
  348. This is the number of days after which a personal message is automatically
  349. killed. A setting of 0 disables the function.
  350. The default is 30. Valid range is 0 to 265
  351.  
  352. LOCALINCOLOUR <colour>
  353. Colour of text typed at the local keyboard.
  354. The default is 11  (Light cyan)
  355.  
  356. LOCALOUTCOLOUR <colour>
  357. Colour of text in response to a local command.
  358. The default is 3  (Cyan)
  359.  
  360. MAILTIME MM MM
  361. A list of minutes past the hour when periodic 'MESSAGE FOR' beacons will be
  362. sent. (Once per hour is normally more than enough!)
  363. The default is no list.
  364.  
  365. MAXCON <number>
  366. Number of incoming connections allowed per user. A MAXCON of 1 is recommended!
  367. This has no effect on the number of outgoing connections from the PMS.
  368. The default is 1. Valid range is 1 to 5
  369.  
  370. MAXFRAME <number>
  371. The maximum number of outstanding frames allowed.
  372. If a valid maxframe can be read from the NODE port during transmission, then
  373. the value read over-rides this setting.
  374. The default is 2. Valid range is 1 to 10
  375.  
  376. MAXLIST <number>
  377. The maximum number of messages that can be listed by the basic List commands.
  378. Set to 0 to disable the restriction.
  379. The default is 50
  380.  
  381. NIC <address>
  382. Your international "address" for use in mail headers.
  383. THIS MUST BE CORRECT or your mail will get lost!
  384. e.g. G8NPF.GB7ESX.#31.GBR.EU
  385. The default is no address.
  386.  
  387. NODECONN <text>
  388. Node reply text for a successful connection.
  389. The default is none.
  390.  
  391. NODEFAIL <text>
  392. Node reply text for a failed connection.
  393. The default is none.
  394.  
  395. NONXPROMPT <text>
  396. This is the extra prompt given to non-expert users.
  397. The default is no extra prompt.
  398.  
  399. NTSBBS <callsign>
  400. This is the callsign of your local (GB7) BBS    (e.g. GB7ESX)
  401. The default is no callsign set.
  402.  
  403. OVERWRITECOLOUR <colour>
  404. The Default is 4
  405.  
  406. PACLEN <number>
  407. The default transmitted packet length. If not specified then a default value
  408. is read from the BPQCFG.BIN file. If a valid paclen can be read from the NODE
  409. port during transmission, then the value read over-rides this setting.
  410. The default is 128
  411.  
  412. PAGEAUDIO ON/OFF
  413. Determines if the 'chat alarm' audio is on or off.
  414. The default is ON
  415.  
  416. PAGETIMEOUT <seconds>
  417. Sets the time delay before a 'not home' reply is given to a Page (T) command.
  418. The default is 20 seconds
  419.  
  420. PORTnCOLOUR <colour number>
  421. Colour of text from BPQ radio port n. (1 to 16)
  422. The default colour is 7 (White) for all ports.
  423.  
  424. PRINTER <printer port>
  425. Sets the I/O port used for the printer. (PRN: LPT1/2/3: COM1/2:)
  426. The default is LPT1:
  427.  
  428. PRINTERFILTER <start-end>
  429. PRINTERFILTER <n1,n2,n...>
  430. Range of ascii codes, or list of individual ascii codes to be excluded from the
  431. printer. Some controls codes can confuse printers. All control codes (0-31) may
  432. be excluded. This will not effect the normal CR/LF sequence being sent to the
  433. printer at the end of a line, but will stop CR or LF codes that appear in 
  434. monitored (compressed) text from getting to the printer.
  435. The default is none excluded.
  436.  
  437. PURGETIME HH:MM
  438. A list of times for the PMS to do its housekeeping. You can enter several times
  439. in the HH:MM format, but two should be enough. Pick quite times as, if the PMS
  440. is very busy, the purge may not take place. Server commands (REQDIR etc.) are
  441. also processed at this time. You must put at least one entry in the list. See
  442. the "Setting of times" section for more details on how to set times.
  443. The default is no list.
  444.  
  445. REGISTRATION <number>
  446. Your PMS registration number. For registered users only.
  447. The default is 'unregistered'.
  448.  
  449. REJECT <list of invalid calls>
  450. A station attempting to log-on using a callsign in this list will be rejected.
  451. The list should include invalid calls like  NOCALL PK232  etc.
  452. This should not be used to prevent a valid callsign from gaining entry.
  453. (Undesirables can be locked out by removing their 'C' flag)
  454. The default is no list.
  455.  
  456. REVIEWSIZE <number of lines>
  457. Sets the number of lines you can scroll back in review mode.
  458. The default is 50. The valid range is 30 to 1000
  459.  
  460. ROUTEID <Text>
  461. Optional info text to be added to R: routing line.  (Max. 26 characters)
  462. Don't include the square brackets or the PMS type/version. They are added
  463. automatically.
  464. The default is no text. 
  465.  
  466. SAVEDIR <drv\directory>
  467. Specifies an alternative drive\directory to save deleted messages in.
  468. The drive and directory must exist!
  469. The default is \PMS\SAVED\
  470.  
  471. SAVETYPE <BPZUA>
  472. Determines the type of messages copied to the SAVEDIR\ directory.
  473. Types are:  B Bulletin   P Personal   Z autoread   U user   A ack
  474. The default is NONE
  475.  
  476. SCREEN 25/43/50       (Experimental only)
  477. The number of lines displayed on the screen. As this command calls the DOS MODE
  478. command, I don't know if it will work correctly with all versions of DOS.
  479. I hope to remove the need for the DOS MODE command, in a future version.
  480. Also, It may not operate correctly when running under DESQview.
  481. The default is 25 lines.
  482.  
  483. SCREENFILTER <start-end>
  484. SCREENFILTER <n1,n2,n...>
  485. Range of ascii codes, or list of individual ascii codes to be excluded from the
  486. screen display and keyboard input. This is mainly to prevent monitored
  487. (compressed) text from corrupting the screen display, particually if ANSI.SYS
  488. is being used. The control codes 7,8,10 (BS,Bell,LF) are always excluded.
  489. The default is no codes excluded (other than 7,8,10).
  490.  
  491. SECURITY <character(s)>
  492. Extra text required if the station that's connected is using the same callsign
  493. as the PMS.
  494. The default is two dots ..
  495.  
  496. SESSIONTIMEOUT <seconds>
  497. This is the maximum time a user can stay connected before the PMS automatically
  498. disconnects.  3599 will give 59 minutes 59 seconds. (The maximum allowed)
  499. The default is 3500. The valid range is 600 to 3599
  500.  
  501. SYSTEMCOLOUR <colour>
  502. Colour of system generated text.
  503. The default is 2  (Green)
  504.  
  505. TEXTBUFFERSIZE <number of lines>
  506. Sets the maximum number of lines available to the system editor.
  507. Files will be truncated to fit the the limit.
  508. The default is 500 lines. The valid range is 50 to 5000
  509.  
  510. THIRDPARTY 0-2
  511. If 0, then only the PMS SysOp can send 3rd party messages.
  512. If 1, then stations with the 'S' access flag set will be able to send 3rd party
  513.       messages.
  514. If 2, then 3rd party messages will be accepted from ANY station. (!)
  515. The default is 1
  516.  
  517. TIMESIG <gmt/utc/bst/...>
  518. The PMS time signature.  This should match the time set in the computer.
  519. The default is gmt
  520.  
  521. TIMEZONE <zone>
  522. The time zone id used in the PMS mail header.
  523. The default is z
  524.  
  525. UPCALL (bbscall>uicall)
  526. The callsigns to watch for in FBB BBS Unproto broadcasts. i.e. GB7HSN>FBB
  527. The default is no callsigns set.
  528.  
  529. UPLISTSIZE <size>
  530. The maximum size of the Unproto list. This list is held in memory, (with a
  531. copy on the hard disk) so the size can be important.
  532. The default is 50 lines.  The valid range is 20 to 500
  533.  
  534. UPPORT <port number>
  535. The BPQnode *RADIO* port for Unproto list update requests to the FBB BBS.
  536. This should normally be the port that you receive FBB Unproto broadcasts on.
  537. The default is 0  (invalid port)
  538.  
  539. UPREQUEST YES/NO
  540. Enable FBB unproto update requests from the PMS.
  541. The default is NO
  542.  
  543. UPTIMER <seconds>
  544. Time delay, in seconds, before requesting FBB unproto updates. 
  545. The default is 150.  The valid range is 60 to 1000
  546.  
  547. UPLOAD <drv:\path>
  548. Alternative directory path for the user upload files area. Should be different
  549. to the download files area.
  550. The default is \PMS\FILES.ULD\
  551.  
  552. USEWP 0-15
  553. 1  Search WP file to see if @BBS matches records. Warn user if different.
  554. 2  Use WP entry if a message is entered with no @BBS field.
  555. 4  Update the WP file with Home BBS's extracted from AutoRead messages.
  556. 8  Allow entries from message headers to update direct user entries(!)
  557. Values may be combined as required.
  558.  
  559. Example values for USEWP:
  560. 0    The White Pages file is kept updated, but not used.
  561. 1    The WP file is searched when a message is entered, to warn the user if the
  562.      @BBS field used differs from the one in the WP file.
  563. 2    The WP entry will be used if a message is entered with no @BBS field
  564. 3    Both options 1 & 2
  565. 4-7  As 0-3, but also the Home BBS's of extracted from messages read by the
  566.      AutoRead function are added to the WP file. Setting to 4+ will result in
  567.      the WP file growing much faster, but it will then record the Home BBS's of
  568.      all stations whose messages pass through the PMS. Otherwise it will only
  569.      record WP info on stations who send messages specifically to the PMS.
  570. 8-15 As 0-7, but will allow Home BBS's read from message headers to update
  571.      (overwrite) direct user entries.
  572. The default is a value of 3 (options 1 and 2)
  573.  
  574. TEMPDRIVE drv:(\path\)
  575. Specifies an alternative hard disk or virtual (ram) disk for temporary files.
  576. A ram disk MUST exist. The PMS cannot create it!
  577. The default is to use the PMS\SYS directory on the current drive.
  578.  
  579. VDU MONO/COLOUR/MONOVGA
  580. Set to MONO if you are using a MDA or Hercules card.
  581. Set to COLOUR if you are using a CGA/EGA/VGA card with colour monitor.
  582. Set to MONOVGA if you are using a CGA/EGA/VGA card with mono monitor.
  583. The default is COLOUR
  584.  
  585. WIDTH <width>
  586. The maximum line length (screen width) in the editor.
  587. The default is 80 (full screen)
  588.  
  589. YAPPCR YES/NO
  590. If NO, then standard Yapp protocol is used.
  591. If YES, then YappC checksum (FBB) and crash recovery protocols are enabled.
  592. The default is YES
  593.  
  594. ******
  595. (Command list terminator. Must be included).
  596.  
  597. -------------------------------
  598.  
  599. "Multi-line" commands. These commands may use more than one line. Text may
  600. include $x variables. The command separator must be at least 5 dashes (-----)
  601. Don't include any text on the command line.
  602. The defaults are pre-set messages.
  603.  
  604. BBSLOGON
  605. <Text>
  606. The text sent to BBS stations (those with user BBS flag set) at log-on.
  607.  
  608. BEACONTEXT
  609. <Text>
  610. The text used in the PMS's MAIL beacons.
  611.  
  612. BYE
  613. <Text>
  614. The text sent in response to a B (Bye) or Q (Quit to node) command.
  615.  
  616. GREET
  617. <Text>
  618. Additional text sent to users without the SHORT flag set.
  619.  
  620. MESSAGEFOOTER
  621. <Text>
  622. Optional text included at the end of all messages originated at the keyboard.
  623. The default is no footer.
  624.  
  625. MESSAGEHEADER
  626. <Text>
  627. Optional text included at the start of all messages originated at the keyboard.
  628. The default is no header.
  629.  
  630. PAGENO
  631. <Text>
  632. The text sent for a negative response to a SysOp Page. (Page-Down or Time-out)
  633.  
  634. PAGEYES
  635. <Text>
  636. The text sent for a positive response to a SysOp Page. (Page-Up)
  637.  
  638. PROMPT
  639. <Text>
  640. The text sent as the PMS prompt.
  641.  
  642. QUOTEHEADER
  643. <Text>
  644. Optional header text to a quoted message.
  645. The default is no header.
  646.  
  647. WELCOME
  648. <Text>
  649. Text sent to normal users at log-on.
  650.  
  651. ******
  652. (Command list terminator. Must be included).
  653.  
  654.  
  655. See the sample npfpms.cfg file for details.
  656.  
  657. -------------------------------------------------------------------------------
  658. Script files.
  659.  
  660. The first 4 files are sent to users at log-on. They will NOT sent to users
  661. flagged as BBS stations in the user file.
  662.  
  663. INTRO.TXT    is sent to all users at log-on
  664. ALLMSG.TXT   is sent to users without the SHORT flag set.
  665. NONXMSG.TXT  is sent to non-expert users.
  666. NONREG.TXT   is sent to a user who has used the PMS before, but has not
  667.              registered by entering their Name, QTH and HomeBBS details.
  668.  
  669. HELP.TXT     is sent in response to the H (Help) command.
  670. INFO.TXT     is sent in response to the I (Info) command.
  671. FILES.TXT    is sent after a W (directory listing) command.
  672.  
  673. You may edit these text file with any ASCII editor. They can contain anything
  674. you think appropriate.
  675.  
  676. -------------------------------------------------------------------------------
  677. WP (White pages) file.
  678.  
  679. The PMS maintains a 'White pages' file of stations home BBS's
  680. The use of this file depends on the setting of USEWP in the npfpms.cfg file.
  681.  
  682. The file will be updated when a user's Home BBS is entered with the NH command,
  683. and may be updated when Home BBS's are read from message headers (R: lines)
  684. in messages sent or forwarded to the PMS. Direct user entries will not be
  685. altered by information read from message headers, unless bit 4 of USEWP is set.
  686.  
  687. The WP entry is also updated if the SysOp changes the users home BBS entry
  688. in the user database file, with the EU xxxxx command.
  689. (Note. The reverse is not true. The user database file is not altered when the
  690. WP file is updated)
  691.  
  692. When a user enters a message, the PMS will look up the home BBS of the station
  693. in the TO field. If an entry is found, and the user did not specify any @BBS,
  694. then the PMS may add the BBS found in the WP file. If the user gave a @BBS
  695. that is different to the @BBS in the WP file, the PMS may warn the user that
  696. the @BBS they just entered may be incorrect.
  697. e.g.
  698. If G9AAA is in the WP file as having a home BBS of GB7ESX.#31.GBR.EU then,
  699.  SP G9AAA    will be translated to:  SP G9AAA @GB7ESX.#31.GBR.EU
  700.  SP G9AAA @GB7NNA will warn the user that the @BBS used may be incorrect.
  701.  
  702. You may override the WP entry by using the following options: 
  703.  SP G9AAA@   will always be translated to:  SP G9AAA @G9AAA
  704.  SP G9AAA@*  will always be translated to:  SP G9AAA         (local message)
  705.  
  706.  
  707. ------------------------------------------------------------------------------
  708. The SU command.   Only available to SysOp.
  709.  
  710. To leave a message to all users use:  SU ALL   (Syntax as in the SP command).
  711. The message is posted in the usual way. The message will be flagged as an
  712. unread personal message to all users. The user List and Read commands will
  713. treat the message as if it was an unread personal message.  The user cannot
  714. kill the message. To prevent it being offered again, the user should use a List
  715. command after reading it.
  716.  
  717. ------------------------------------------------------------------------------
  718. Carbon Copy (CC) messages.
  719.  
  720. Multiple personal messages to all callsign's in a group.
  721. This type of message may be sent by any user with their 'S' access flag set if
  722. THIRDPARTY is set to 1, or by anyone if THIRDPARTY = 2
  723. The syntax is:  SP <groupname> (@BBS)
  724.  
  725. Note: It must be SP and not SB. A type SB will not be copied.
  726.  
  727. To create a Carbon Copy group you create a file, which must reside in the
  728. CONFIG directory, with the group name followed by a .cc extension.
  729. i.e.  EPG.CC
  730. The file should contain the callsign(s) of users allowed to send messages to
  731. the group, plus the callsign's and home BBS's of all the users to whom the
  732. message will copied.
  733.  
  734. e.g. Contents of file EPG.CC
  735.  
  736. G9XXX               ;List of callsign's allowed to send messages to the group.
  737. G9YYY
  738. G9ZZZ
  739. ******              ;Separator. Must be at least five 'stars'
  740. G9AAA @ GB7ESX      ;List of recipients.
  741. G9BBB @ GB7NAA
  742. G9CCC
  743. G9DDD @ GB7ESX
  744. G9EEE @ GB7ESX
  745.  
  746. Stations G9XXX, G9YYY and G9ZZZ can send messages to the EPG group by entering
  747. 'SP EPG'. The message is sent in the normal way. When the message is finished
  748. multiple messages are created from the original message. The station sending
  749. the message is informed the CC messages are being created, unless that station
  750. is a BBS.
  751.  
  752. If you often need to send several copies of the same message to another BBS it
  753. might make sense to ask the other BBS to create a Carbon Copy file containing a
  754. list of the users you wish to send messages to on his BBS. Then only one copy
  755. of the message would need to be sent to the other BBS.
  756. For example, with the EPG group, if GB7ESX had a CC file for EPG group members
  757. called EPGMEM on his BBS, then the local EPG.CC file could read:
  758.  
  759. G9XXX
  760. G9YYY
  761. G9ZZZ
  762. ******
  763. EPGMEM @ GB7ESX
  764. G9BBB @ GB7NAA
  765. G9CCC
  766.  
  767. So only one message would be sent to GB7ESX instead of three. The result would
  768. be the same as sending three individual messages to GB7ESX. Of course the above
  769. would only work if GB7ESX was set up to allow this!
  770.  
  771. The SysOp can always send a message to any CC group even if his callsign in not
  772. in the CC list. You may create as many CC groups as required.
  773. Make sure the names are unique and are not the same as commonly used BBS TO
  774. fields. (Like ALL SYSOP HELP etc.) and are no more that 6 characters long.
  775. After the message is copied to all the callsign's in the CC list the original
  776. message is killed. The copies will be automatically marked for forwarding, if
  777. appropriate.
  778.  
  779.  
  780. ------------------------------------------------------------------------------
  781. Command history buffer.
  782.  
  783. Previous keyboard typed commands are saved in a 15 line cyclic buffer.
  784. Use up arrow and down arrow to cycle through the buffer.
  785.  
  786. -------------------------------------------------------------------------------
  787. Input line editing.
  788.  
  789. The 'cursor' can be moved with the <arrow>, <Home>, <End> and <Ctrl arrow> keys
  790. The insert key will toggle insert mode on and off. The letter I shows in the
  791. status line when insert is on.  <Ctrl Y> or <Esc> will cancel the entire line.
  792. The edit cursor will show as inverted flashing text. The normal cursor shows
  793. as an underscore.
  794.  
  795. ------------------------------------------------------------------------------
  796. Listing pause option.
  797.  
  798. Assuming ListPause is set to on (P ON) for the user or SysOp....
  799. If a user is connected, then listings will pause approximately every 15 lines
  800. and the user is asked:  -- More Y/n >
  801. When the SysOp is using the local keyboard, listings will pause at
  802. approximately one pagefull. The actual number of lines displayed per page
  803. depends on the screen mode.
  804.  
  805. ------------------------------------------------------------------------------
  806. JA command.
  807.  
  808. The JA command can accept 3 parameters (in any order).
  809. 1. The number of entries to search. (Defaults to 12)
  810. 2. The callsign/alias to search for. Partial callsign will also be matched
  811.    unless the callsign is entered with a trailing -
  812. 3. The BPQ port n, as P=n
  813.  
  814. e.g.            (... is anything)
  815.   JA            List the last 12 entries
  816.   JA 25         List the last 25 entries
  817.   JA G9ABC      List all entries for G9ABC...
  818.   JA G9ABC-1    List all entries for G9ABC-1...
  819.   JA GB7E       List all entries for GB7E...
  820.   JA GB7ES-     List all entries for GB7ES only
  821.   JA 30 P=1     List the 30 most recent entries on port 1
  822.   JA G9ABC P=2  List all entries for G9ABC... on port 2 only
  823.   JA P=1        List all entries on port 1
  824.   JA P=3 40     List the last 40 entries on port 3
  825.  
  826. -------------------------------------------------------------------------------
  827. PMS status lines.
  828.  
  829. The top status line indicates:
  830. Session xx:xx    The session timer.
  831. Wait    xx:xx    The inactivity timer.
  832.  
  833. The second status line indicates:
  834. Cnn              The pms channel number.
  835. Hnn              The BPQ host port number.
  836.  
  837. Ch nnnn..        Channel activity indicators.
  838.  
  839. nnnn             Internal status indicator.
  840. UP               Indicates the PMS is able to request FBB unproto updates.
  841.  
  842. U=nn             The number of unacknowledged packets pending.
  843. Q=nn             The number of packets queued for receive.
  844. B=nnn            The number of buffers left in the BPQ node.
  845.  
  846.  
  847. The lower status line of the screen display indicates:
  848. ISCA        Insert/Shift/Alt/Ctrl key status.
  849. ------      The callsign of the station connected to this channel.
  850. Status      The current mode of operation.
  851. Serv        Upload/Download file servers enabled/disabled.
  852. Busy        The busy status of the PMS channel and/or BPQ host port.
  853. Capt        Receive capture file (to disk) active.
  854. Mon         The monitor status of the BPQ host port.
  855. Print       The 'output to printer' status.
  856. M:nnnn      Monitor port mask (in hex).
  857. :<callsign> Selective monitor callsign
  858.  
  859. -------------------------------------------------------------------------------
  860. System errors.
  861.  
  862. The PMS will attempt to recover from some system errors.
  863. If possible, it will disconnect any users, close down, and then re-boot the PMS
  864. code. Depending on what had gone wrong, this may or may not work, but if it
  865. fails, nothing is lost by trying!
  866.  
  867. -------------------------------------------------------------------------------
  868. User sub-directories.
  869.  
  870. The SysOp can set up user sub-directories in the FILES directory.
  871. The directory format is:  G9ABC.USR   (The extension must be .USR)
  872. Only a user with a matching callsign will have access to the files in a .USR
  873. sub-directory. You may have as many .USR sub-directories as you wish.
  874.  
  875. -------------------------------------------------------------------------------
  876. Time-outs.
  877.  
  878. The session time-out (Session) will disconnect a user after the time specified
  879. by the SESSIONTIMEOUT entry has expired.
  880.  
  881. The inactivity time-out (Wait) will disconnect a user after the time specified
  882. by the INACTIVETIMEOUT entry has expired without ANY input to the PMS.
  883.  
  884. If a user times out during a file upload/download the time-out is 'held' until
  885. the file transfer is completed. The time-out then takes effect.
  886.  
  887. The session and inactivity time-outs are suspended during CHAT sessions and
  888. when in TERMINAL mode, and also when the station connected is logged in with
  889. SysOp status.
  890.  
  891. (Remember the time-out counters can be manually re-set with the F7 and Shift/F7
  892. function keys)
  893.  
  894. -------------------------------------------------------------------------------
  895. Setting of times.  (For forwarding, AutoList etc.)
  896.  
  897. The list should be in the form of HH:MM HH:MM or xx.MM
  898. Times can also have a 'days of the week' parameter.
  899. Those times will only be used if the current day is included in the parameter.
  900. This can be used to stop forwarding on busy days (i.e. weekends).
  901.  
  902. e.g.   FWDTIME 10:22/145  05:15/23456  16:45
  903.    The 10:22 time will only operate on days 1,4 and 5
  904.    The 05:15 time will only operate on days 2,3,4,5,6  (i.e. Not Sat or Sun)
  905.    The 16:45 time will operate on any day.
  906.  
  907. The form xx:MM is for MM minutes past the hour, every hour.
  908. e.g.   FWDTIME xx:25
  909.    Will forward at 25 mins past the hour, every hour.
  910.      
  911.        FWDTIME xx:45/23456
  912.    Will forward at 25 mins past the hour, every hour, but only Mon-Fri.
  913.  
  914. Specific times, and mins past the hour may be combined.
  915.        FWDTIME xx:45/23456 01:35/17
  916.    Will forward at 45 mins past the hour Mon-Fri and at 01:35 on Sat and Sun.
  917.      
  918. (Day 1 is Sunday, Day 7 is Saturday)
  919.  
  920. Do not set a time to exactly on the hour as that's when the PMS saves its
  921. data cache to disk, and runs its external batch file.
  922.  
  923. -------------------------------------------------------------------------------
  924. Syntax of connect paths for Forwarding, AutoList etc.
  925.  
  926. The connect path commands consist of a list of commands & nodes to connect
  927. through, ending in the callsign of the station you wish to connect to,
  928. separated by colons.    i.e.   C G8NPF-1:C G1NNB:C GB7NNA
  929.  
  930. You can force a BPQ switch to connect on a specific port by using the nodes
  931. alias with a dummy SSID, rather than its callsign, and prefixing the BPQ port
  932. number to the alias.
  933. i.e.   instead of using   C G8NPF-1:C G1NNB:C GB7NNA
  934.        use                C G8NPF-1:C 2 ESX-2:C GB7NNA
  935. This will connect normally to node G8NPF-1 first, and then try to connect via
  936. G8NPF-1's port number 2 to G1NNB's node alias ESX, and then to GB7ESX
  937. Forcing a connect on a specific BPQ port only works if you use a node alias
  938. with a dummy SSID number.
  939.  
  940. Apart from the above use, it is best to use a nodes real callsign, rather than
  941. its alias, when setting up connect paths.        
  942.  
  943. The 'connect command' is normally 'C' but can also be 'X' if you are 
  944. cross-connecting via a KA node. If the connect command is omitted, the a C is
  945. assumed.
  946. i.e.    C G8NPF-1:C G1NNB:C GB7NNA   (Normal connect)
  947.         G8NPF-1:G1NNB:GB7NNA         (Same as above)
  948.         C KEPAC3:X GB7DUG            (Cross connect via KA node KEPAC3)
  949.  
  950. -------------------------------------------------------------------------------
  951. Automatic Forwarding protocol.
  952.  
  953. When setting up your FWDFILE.LST the LAST entry *MUST* be your local NTSBBS
  954.  
  955. When the PMS starts a forwarding session it will scan the FWDFILE.LST file and
  956. forward any messages it finds for stations included in the list.
  957. When it gets to the NTSBBS entry, any messages (with an @BBS field) for
  958. stations not in the FWDFILE.LST file will be sent to the NTSBBS.
  959.  
  960. Messages with @BBS fields unknown to the PMS (like @EU @WWW @WA7XYZ) will
  961. always be sent to the NTSBBS.
  962.  
  963. The PMS can forward to another system (TCP/IP system?), which uses the same
  964. BASE callsign as the PMS, just with a different SSID.
  965. Just add a normal entry to the forwarding file (fwdlist.lst) like:
  966.  C (port) (node:)G8NPF-5
  967. Then post the messages to be forwarded like:  SP G9ABC@G8NPF.ampr.org (or SB..)
  968. The .ampr.org extention prevents the PMS from stripping the @BBS field, and it
  969. will forward the messages to the other system.
  970.  
  971. Note: Whilst its ok to modify existing entries in the fwdlist.lst file while
  972. the PMS is running, if you add a new entry you should re-start the PMS so that
  973. it will re-scan the list.
  974.  
  975.  
  976. ------------------------------------------------------------------------------
  977. BBS/PMS SID letters.
  978.  
  979. When the PMS connects to a BBS for forwarding it checks the SID of the BBS.
  980. Typically, the BBS SID may be something like  [NNA-2.02-BFHLM$]
  981.                                           or  [FBB-1.00-ABFHM$]
  982. The PMS will support the use of BID's for bulletins if the BBS has included
  983. the $ character in its SID. (All known software does).
  984. It will also use use MID's for personal messages if the BBS has included a M
  985. in its SID. Note, if the SID includes the letter L, then the letter M is
  986. assumed, even if its not actually there.
  987.  
  988. The letter A indicate the PMS/BBS can support FBB's ACK: type messages.
  989. The letter V indicate the PMS/BBS can support NNA type password verification.
  990. The letter F indicate the PMS/BBS can support FBB's bulk ascii forwarding.
  991. The letter B indicate the PMS/BBS can support FBB's bulk compressed forwarding.
  992. If you include the letter B you MUST also include the letter F
  993.  
  994. The letter L indicates the PMS/BBS supports NNA's bulk compressed forwarding.
  995. The letter L over-rides BF. If both PMS & BBS have the letters BFL in their
  996. SID's then NNA bulk forwarding will be used in preference to FFB forwarding.
  997.  
  998. If both PMS & BBS included a H in their SID, then the PMS will use the full
  999. address of a station, if known.  (e.g. G8NPF@GB7ESX.#31.GBR.EU)
  1000. Normally it is not necessary (or desirable?) for the PMS do do this, as routing
  1001. is best left to the BBS.
  1002.  
  1003. If your current version of the PMS SID includes the letter P then it MUST be
  1004. removed as the old style NNA compression is no longer supported by the PMS
  1005. (or by NNA!)
  1006.  
  1007. The $ should be the last letter, to retain compatibility with early MBL/RLI
  1008. systems.
  1009.  
  1010. The PMS SID should normally be  ABFLMHV$
  1011.  
  1012. ------------------------------------------------------------------------------
  1013. Forwarding and the optional parameters  > < @ #
  1014.  
  1015. > = To
  1016. < = From
  1017. @ = at BBS
  1018. # = a message number
  1019.  
  1020. Normally, only messages with an @BBS field that matches the callsign of the
  1021. station being forwarded to, will be forwarded to that station.
  1022. i.e. only messages addressed  xxxx@G9ABC  would be forwarded to G9ABC.
  1023. You can force the PMS to forward other message groups by adding the parameters
  1024. >callsign  <callsign  @BBS  #msgnumber  to the forwarding command.
  1025.  
  1026. When using the manual forwarding command FD (or poll command PL):
  1027. FD G9ABC-3 >WNOS #1234
  1028. will forward to G9ABC all messages addressed @G9ABC, any messages addressed to
  1029. WNOS, and the specific message numbered 1234, regardless of how it is addressed
  1030.  
  1031. The same format can also be used in the automatic forwarding file FWDLIST.LST
  1032. to always include certain groups of messages in a forwarding session.
  1033. e.g.   C G8NPF-1:C G9ABC-3 >DEBATE
  1034. will always forward messages addressed to DEBATE to station G9ABC-3 as well as
  1035. any messages addressed @G9ABC
  1036.  
  1037. Note:
  1038. Personal messages (PW) can only be forwarded once, so if you re-direct a
  1039. personal message to another station its status will become PF, and so it will
  1040. not be forwarded to the addressee as well. (Unless you use the MM command to
  1041. change its status back to PW)
  1042. Bulletins (B$) do not get their status changed after forwarding, so they can be
  1043. forwarded to more than one station. 
  1044.  
  1045. -------------------------------------------------------------------------------
  1046. Automatic password exchange with the SID V option. (NNABBS)
  1047.  
  1048. If both your PMS, and the station you are forwarding to, have the automatic
  1049. password verification option set (letter 'V' in SID) then the system will
  1050. insist on a password exchange. If either station does not have the correct
  1051. password matrix, the system will disconnect.
  1052.  
  1053.  
  1054. -------------------------------------------------------------------------------
  1055. -------------------------------------------------------------------------------
  1056. Special control key combinations.
  1057.  
  1058. The <Ctrl><Left-Shift> key combination.
  1059. Holding down these keys will:
  1060. 1. Inhibit the MAIL beacon after a user disconnects, or whenever the PMS is
  1061.    about to send a MAIL beacon.
  1062. 2. Terminate a FORWARD, POLL or AUTOLIST session at the end of the current
  1063.    connection.
  1064. 3. Will abort a users listing as if the user had sent an abort (A) command.
  1065. 4. Will prevent the PMS from re-booting after closing down with an error
  1066.    condition.
  1067.  
  1068.  
  1069. The <Alt><Left-Shift> key combination.    (Similar to F12 key)
  1070. Pressing these keys will switch the PMS display to the next channel up.
  1071.  
  1072. The <Alt><Right-Shift> key combination.   (Similar to F11 key)
  1073. Pressing these keys will switch the PMS display to the next channel down.
  1074.  
  1075. The <Ctrl><Right-Shift> key combination.
  1076. Holding down these keys will 'dump' a user. The user is disconnected without
  1077. warning!
  1078.  
  1079. The <Alt><(0-9)> key combination.
  1080. Pressing Alt(0-9) will switch the PMS display to that channel (if valid).
  1081.  
  1082. <PageUp> & <PageDown> keys.
  1083. 1. Used in response to a chat request alarm from a user.
  1084. Pressing <PageUp> will advise the user that you are ready to chat.
  1085. Pressing <PageDown> will advise the user that you are not available.
  1086. (Doing nothing will also give the unavailable response after a short delay).
  1087. 2. When a user is connected to the PMS, pressing <PageUp> will advise the user
  1088. that you wish to chat to them. <PageDown> terminates the chat and puts the user
  1089. back to the normal PMS.
  1090. The <PageUp> and <PageDown> keys ONLY work when the PMS is connected to a user.
  1091.  
  1092. The <Tab> key.
  1093. When in TERMINAL or CHAT mode, the <Tab> key will add 3 chevrons plus a
  1094. <Return> to the input line.   >>><Cr>
  1095.  
  1096. -------------------------------------------------------------------------------
  1097. Message status flags.
  1098.  
  1099. Flag       Meaning               Number (in hex)
  1100.  0   RBA   Read by addressee     0x = Number of times read
  1101.                                  8x = Read by SysOp
  1102.                                  
  1103.  1   RBO   Read by others        xx = Number of times read
  1104.  
  1105.  2   TYP   Message type          01 = Bulletin (B)
  1106.                                  02 = Personal (P)
  1107.                                  04 = AutoRead (Z)
  1108.                                  08 = User     (U)
  1109.                                  10 = ACK      (A)
  1110.                                  20 = (spare)
  1111.                                  40 = (spare)
  1112.                                  80 = Undetermined type
  1113.  
  1114.  3   CMP   Completed             00 = Message Incomplete
  1115.                                  01 = Message completed
  1116.                                  Cn = Incoming message on channel n
  1117.  
  1118.  4   KOF   Kill on forwarding    00 = Do not kill
  1119.                                  01 = Kill after forwarding
  1120.  
  1121.  5   FWT   Forward type          x0 = Not for forwarding
  1122.                                  x1 = Waiting for normal forwarding
  1123.                                  1x = Forward only. No local read
  1124.                                  2x = Message still being received
  1125.                                  8x = Flagged for SysOp's attention
  1126.  
  1127.  6   FWD   Forwarded             00 = Not yet forwarded 
  1128.                                  01 = Read by addressee before being forwarded
  1129.                                  08 = Forwarded
  1130.  
  1131.  7   ACT   Active flag           Bit field
  1132.                                  .... ...0 = Killed
  1133.                                  .... ...1 = Active 
  1134.                                  ...1 .... = On hold
  1135.                                  ..1. .... = Locked by message editor
  1136.                                  .1.. .... = Un-killable (by user/auto system) 
  1137.                                  1... .... = Un-deleteable (by auto system) 
  1138.         x = anything 
  1139.         . = 0 or 1
  1140.  
  1141. A typical MS (Message Status) might produce:
  1142.  
  1143. RBA - &H01     Read once by the addressee
  1144. RBO - &H02     Also read twice by other stations
  1145. TYP - &H01     Bulletin message
  1146. CMP - &H01     The message is complete
  1147. KOF - &H00     Don't kill after forwarding
  1148. FWT - &H01     Message for normal automatic forwarding
  1149. FWD - &H08     Has been forwarded successfully
  1150. ACT - &H01     An active message.
  1151. 000000000000000000000000000000000000000000000000000000100100011
  1152.  
  1153. The last line is the flags which indicate which stations already have the
  1154. message. These bits correspond to the (reverse) order of the stations listed in
  1155. the CONFIG\dupcheck.lst file.
  1156.  
  1157. To change a message's status use MM followed by a list of parameters in the
  1158. same order as the MS list. Use a * to leave a flag unchanged. You only need to
  1159. enter parameters up to the one you wish to change.
  1160.  
  1161.   e.g. Assume that message number 123 has been entered onto the system 
  1162.   as a bulletin, and you wish to change this to a personal message....
  1163.  
  1164.    MM 123 * * 2
  1165.  
  1166.   ....will do the trick. Flags 0 and 1 remain unchanged. Once the change has
  1167.   be made to the relevant flag, no more asterisks need be added.
  1168.   Numbers can be entered using any valid number system. 
  1169.   i.e.  &HF1  &B11110001  241  F1H   are all the same value.
  1170.  
  1171. When changing a flags value, be careful to only change the bits required!
  1172.  
  1173.  
  1174. Special message types.
  1175.  
  1176. 'Un-killable' and 'Un-deleteable' messages.
  1177. Only the SysOp can kill/delete this type of message, after setting the status
  1178. back to normal. The auto housekeeping function will not be able to kill or
  1179. delete them either. 
  1180.  
  1181. -------------------------------------------------------------------------------
  1182. Screen filter.
  1183.  
  1184. By default, control codes 7,8 and 10 (BS, Bell and LF) are filtered from the
  1185. screen display and from keyboard input. If other control codes cause a problem
  1186. you can filter them out with:
  1187. SCREENFILTER <start-end>   to filter out a range of codes, or
  1188. SCREENFILTER code1,code2,code3....  to filter out a list of individual codes.
  1189. You can use multiple SCREENFILTER commands.
  1190.  
  1191. -------------------------------------------------------------------------------
  1192. Printer filter.
  1193.  
  1194. You can filter out codes from the printer with:
  1195. PRINTERFILTER <start-end>  to filter out a range of codes, or
  1196. PRINTERFILTER code1,code2,code3....  to filter out a list of individual codes.
  1197. You can use multiple PRINTERFILTER commands
  1198.  
  1199. i.e.
  1200. PRINTERFILTER 0-9
  1201. PRINTERFILTER 11,12
  1202. PRINTERFILTER 14-31
  1203. will filter out all control codes except Line-Feed and Carrage-Return (10 & 13)
  1204. This will normally be required to prevent the printer going wild!
  1205.  
  1206. Some printers may require codes 128-255 to be filtered out as well.
  1207.  
  1208. -------------------------------------------------------------------------------
  1209. Printer control.
  1210.  
  1211. The PMS attempts to manage printer output, to prevent an attempt to print to a
  1212. printer that is off-line, or otherwise unavailable, from hanging the PMS.
  1213. However, pressing the Print-Screen key to dump the screen to printer with the
  1214. printer unavailable (switched off or buffer full) may cause ALL the PMS windows
  1215. to freeze until the printer dump has finished.
  1216.  
  1217. -------------------------------------------------------------------------------
  1218. Dump user.
  1219.  
  1220. A user may be dumped at any time by pressing, and holding, the
  1221. <Right Shift> and <Right Ctrl> keys simultaneously. The user is disconnected
  1222. immediately without any warning even if in the middle of a file up/download.
  1223. This should be regarded as a last resort 'Panic Button' only.
  1224.  
  1225. -------------------------------------------------------------------------------
  1226. Compressed message forwarding.
  1227.  
  1228. Compressed message forwarding to/from NNA BBS.
  1229. The PMS is capable of forwarding messages in NNA bulk compressed format to
  1230. other stations using compatible code (NNA/NPFPMS)
  1231. To enable this function include a L in the EXT line in the npfpms.cfg file.
  1232.  
  1233. Compressed message forwarding to/from FBB BBS.
  1234. The PMS is capable of forwarding messages in FBB bulk ascii/compressed format
  1235. to other stations using compatible code (NNA/FBB/NPFPMS)
  1236. To enable this bulk ascii forwarding include the letters F in the EXT line in
  1237. the npfpms.cfg file. To enable this bulk compressed forwarding include the
  1238. letters B in the EXT line in the npfpms.cfg file.
  1239. (If you include the B, then you must also include the F)
  1240.  
  1241. Protocol errors sent out by FBB BBS's.
  1242. --------------------------------------
  1243. 0 : Binary packet is not of header (HD) type when receiving title.
  1244. 1 : Checksum of message is wrong.
  1245. 2 : Message could not be un-compressed.
  1246. 3 : Received binary frame is not DATA (DT), not EOT (ET).
  1247. 4 : Checksum of proposals is wrong.
  1248. 5 : Answer to proposals must start with "F" or "**".
  1249. 6 : Answer to proposals must be either "FF" or "FS".
  1250. 7 : More than 5 answers (with "+", "-" or "=") to proposals.
  1251. 8 : Answer to proposal is not "+", "-" or "=".
  1252. 9 : The number of answers does not match the number of proposals.
  1253. 10: More than 5 proposals have been received.
  1254. 11: The number of fields in a proposal is wrong (6 fields).
  1255. 12: Protocol command must be "FA", "FB", "F>", "FF" or "FQ".
  1256. 13: Protocol line starting with a letter which is not "F" or "*".
  1257.  
  1258. -------------------------------------------------------------------------------
  1259. Review mode.
  1260.  
  1261. A scroll back buffer is available. Press <Ctrl><Page up> to
  1262. activate. You may scroll backwards and forwards with the cursor keys, Page up,
  1263. Page down, Home and End keys. 
  1264. Press <Esc> to exit the review mode.
  1265.  
  1266. -------------------------------------------------------------------------------
  1267. Number formats.
  1268.  
  1269. The PMS will normally accept numeric input in the following formats.
  1270.  
  1271. Decimal         e.g.  1201
  1272. Hex             e.g.  &HA6  or  A6H  or  $A6
  1273. Binary          e.g.  &B100110  or  100110B
  1274. Octal           e.g.  &O102  or  &102
  1275.  
  1276. Invalid numbers (e.g. &HXYZ or &B56) will normally default to zero.
  1277.  
  1278. The highest valid Decimal number is  999999
  1279. The highest valid Hex number is      &H7FFF  (32767)
  1280. The highest valid Binary number is   &B111111111111111  (32767)
  1281.  
  1282. Out-of-range numbers will be forced to within the valid range for the command.
  1283. e.g.  R -6   will be forced to 0  (Negative numbers are invalid)
  1284.       R 1234567  will be forced to 99999  (The highest message number possible) 
  1285.  
  1286. The system will treat all numeric input as DECIMAL unless instructed otherwise!
  1287.  
  1288. -------------------------------------------------------------------------------
  1289. Security code.
  1290.  
  1291. This is a simple security system to trip up the 'casual' hacker trying to
  1292. access the PMS by adopting the PMS's own callsign.
  1293.  
  1294. Add the line:   SECURITY (characters)   to the npfpms.cfg file.
  1295. If anyone logs on to the PMS using the PMS's callsign (SSID ignored), the extra
  1296. characters must be sent before the normal PMS> prompt will be seen. Anything
  1297. else will cause the PMS to terminate the connection. Choose characters that may
  1298. go unnoticed by a casual observer, rather than something obvious.
  1299. i.e.  .@-   would be far less obvious than  SYSOP
  1300.  
  1301. By default the security code is disabled.
  1302.  
  1303. Note:
  1304. If you wish the PMS to accept forwarding from another system using the same
  1305. callsign, then you will need to disable the security feature.
  1306. e.g.  A TCP/IP system with the call G8NPF-5 forwarding to the PMS which has
  1307. the call G8NPF-3
  1308.  
  1309. -------------------------------------------------------------------------------
  1310. User access flags.
  1311.  
  1312. These flags can be set or cleared for individual users by using the Edit User
  1313. command:  EU <callsign>
  1314. The letters in the flag string indicate the following:
  1315.  
  1316. C   Accept connections from this user.
  1317. K   Suppress the listing of killed messages.
  1318. U   Allow user to upload files.
  1319. D   Allow user to download files.
  1320. R   Allow user to read 3rd party messages.  (No effect if THIRDPARTY=0)
  1321. S   Allow user to send 3rd party messages.  (No effect if THIRDPARTY=0)
  1322. A   Allow user to user Remote SysOp command.
  1323.  
  1324. New users will default to         :   D,U,K,C
  1325. The SysOp's entry will normally be:   A,S,R,D,U,K,C
  1326.  
  1327. Using the EU command to change a users access flags.
  1328. To set a flag, enter its letter (with an optional leading + sign)
  1329. To clear a flag, enter its letter with a leading - sign.
  1330. You can optionally seperate the entries with spaces or commas.
  1331. i.e.
  1332.   +C+A-RU
  1333.   +C +A -R U        
  1334.   +C,+A,-R,U
  1335. will all set the C, A and U flags, and clear the R flag.
  1336.  
  1337. ------------------------------------------------------------------------------
  1338. User preference flags.
  1339.  
  1340. These flags can be set or cleared for individual users by using the Edit User
  1341. command:  EU <callsign>
  1342. The letters in the flag string indicate the following:
  1343.  
  1344. X   Expert mode on.
  1345. P   List Pause on.
  1346. L   Reverse list order on (list high to low).
  1347. S   User gets shorter log-on messages.
  1348. B   User is a BBS. No log-on messages.
  1349.  
  1350. The X, P and L flags can be changed by users, with the X, P and LR commands.
  1351. The other flags can only be changed by the SysOp, with the EU command.
  1352.  
  1353. New users will have the 'P' flag set by default.
  1354. Set the 'B' flag for unattended/BBS stations. They do not want any log-on text.
  1355. Set the 'S' flag for regular users, who no longer need the full log-on text.
  1356.  
  1357. Using the EU command to change a users preference flags.
  1358. To set a flag, enter its letter (with an optional leading + sign)
  1359. To clear a flag, enter its letter with a leading - sign.
  1360. You can optionally seperate the entries with spaces or commas.
  1361. i.e.
  1362.   +X+S-BP
  1363.   +X +S -B P        
  1364.   +X,+S,-B,P
  1365. will all set the X,S and P flags, and clear the B flag.
  1366.  
  1367. ------------------------------------------------------------------------------
  1368. Files directory description file.
  1369.  
  1370. An ascii file called CONFIG\filedesc.txt is used to describe all the files
  1371. and sub-directories within the FILES section. See the sample file.
  1372. You must edit this file to suit your files. The maximum number of entries
  1373. scanned in this file is limited by the TEXTBUFFERSIZE setting in the npfpms.cfg
  1374. file. Entries greater than this will be ignored.
  1375. If a file-type is indicated by the type letter:
  1376. A for ASC  T for TXT  B for BIN  D for DIR  Z for ZIP
  1377. Unknown types show as ...
  1378. A file description is not mandatory, but is best included.
  1379.  
  1380. -------------------------------------------------------------------------------
  1381. Text colours.
  1382.  
  1383. The monitored frames from each BPQ host port are displayed in a different
  1384. colour. The colours can be set in the npfpms.cfg file with the commands:
  1385. PORT1COLOUR  to  PORT16COLOUR  (All default to white)
  1386.  
  1387. Other colours are:
  1388. LOCALINCOLOUR   Defaults to light cyan. Mostly used for 'keyboard' text.
  1389. LOCALOUTCOLOUR  Defaults to cyan. Mostly used for 'command replies' text.
  1390. SYSTEMCOLOUR    Defaults to green. Mostly used for 'system' text.
  1391. ERRORCOLOUR     Defaults to light red. Used for error messages.
  1392. KEYBOARDCOLOUR  Defaults to white. 
  1393.  
  1394. Text colours on a VGA system are:
  1395. O   Black
  1396. 1   Blue
  1397. 2   Green
  1398. 3   Cyan
  1399. 4   Red
  1400. 5   Magenta
  1401. 6   Brown
  1402. 7   White
  1403. 8   Gray
  1404. 9   Light Blue
  1405. 10  Light Green
  1406. 11  Light Cyan
  1407. 12  Light Red
  1408. 13  Light Magenta
  1409. 14  Yellow
  1410. 15  High intensity White
  1411.  
  1412. -------------------------------------------------------------------------------
  1413. REQFIL, REQDIR, FNDFIL and WP servers.
  1414.  
  1415. These are described in the file USER.DOC, in the FILES directory.
  1416.  
  1417. -------------------------------------------------------------------------------
  1418. Automatic listing of mail from your NTSBBS with AutoList and AutoRead.
  1419.  
  1420. The PMS supports two types of AutoList function.
  1421. Type A (generic) is suitable use with most types of BBS, in particualar NNA and
  1422. FBB BBS's .
  1423.  
  1424. Type B is for users of FBB BBS's that support UNPROTO LIST broadcasts.
  1425.  
  1426. AutoList Type A.
  1427. ----------------
  1428. The PMS will automatically log on to your local NTSBBS and issue a sequence of
  1429. commands (contained in the file CONFIG\autolist.cmd) to download mail headers.
  1430. The autolist.cmd file will normally just contain a single 'L' list command, but
  1431. the file may contain any valid command(s).  e.g.  L> DEBATE   or   L@ GBR
  1432. All text received from the BBS is written to the AutoListA file.
  1433. The AutoListA file can be browsed/edited by using the <Alt>F6 function key.
  1434.  
  1435. AutoList Type B.
  1436. ----------------
  1437. The PMS will make use of FBB Unproto broadcasts to maintain an up-to-date
  1438. mail header list. The system watches for FBB Unproto UI broadcasts using the
  1439. callsigns specified by the UPCALL command, and automatically adds the received
  1440. lines to the file.If any lines are missing, the PMS will request them
  1441. automatically from the FBB BBS. For this to operate, your FBB BBS SysOp must
  1442. enable your 'U' flag in his BBS setup). The update will be requested on BPQ
  1443. radio port specified with the UPPORT command. This will normally be the port
  1444. you receive the unproto broadcasts on.
  1445.  
  1446. If the BBS can tell the PMS to stop asking for updates if it is not configured
  1447. to allow you to request updates. If this occurs, the only way to re-enable the
  1448. update request function in the PMS is to re-boot the PMS.
  1449. Note:  There is no point in the PMS requesting updates if the BBS is not
  1450. configured to respond to them!
  1451.  
  1452. The AutoListB file can be browsed/edited by using <Ctrl>F6 function key.
  1453.  
  1454. AutoRead.
  1455. ---------
  1456. Editing the AutoList file. (Both types A and B)
  1457. Mark any messages you wish the PMS to Read 'next time round' with a # in the
  1458. first character position. This is done by pressing the <Tab> key to toggle
  1459. a leading # on and off automatically. You can also delete unwanted lines. 
  1460. With a type 2 list, it best not to delete lines near the top of the list.
  1461. The format of the header lines is critical, so you cannot change anything else.
  1462. Most editor functions that alter the text are locked out!
  1463.  
  1464. The next time the PMS performs an AutoList/Read session, it will also do a Read
  1465. of all the messages in the list marked with a #. The messages will be added to
  1466. the PMS message base. After completing a successful read, the # in the list
  1467. will be changed to a *  If the PMS cannot decode a message, the # will be
  1468. changed by a ?  If the message number marked is invalid (not a number?) the #
  1469. will be changed with a !
  1470.  
  1471. The AutoRead function extracts the TO @BBS FROM and SUBJECT fields from the
  1472. message headers received from the BBS, as they appears in the AutoList list.
  1473. The PMS will reconise 3 types of system based on the SID received from the BBS.
  1474. These are NNABBS, FBBBBS and NPFPMS. Anything else is treated as OTHERBBS.
  1475. The PMS needs to know the order of the fields in the message header. The
  1476. default field order expected (for all BBS types) is 4,5,6,8
  1477.  
  1478. For example:
  1479. A typical header from a NNA BBS looks like:
  1480.           Msg#  TS  Size  To     @BBS   From   Date   Subject
  1481.           71812 B$   6780 DEBATE GBR    G9ABC  03-May Debating issues.
  1482. fields>   1     2    3    4      5      6      7      8
  1483. required>                 4      5      6             8
  1484.                 
  1485. A typical header from a FBB BBS looks like:
  1486.           Msg #  TSL  Size To    @BBS    From   Date/Time Subject
  1487.           71651  B$   6780 DEBATE@GBR    G9ABC  0403/1819 Debating issues.
  1488. fields>   1      2    3    4      5      6      7         8
  1489. required>                  4      5      6                8
  1490.  
  1491. So, although the spacing is different, the field order is the same. The actual
  1492. field order may vary depending on how the BBS has been set up, and what
  1493. software it is using.
  1494.  
  1495. If the header from your NTSBBS has the same arrangment of fields, then you do
  1496. not need to alter the default configuration. If the order of the fields differs
  1497. you must specify the field order in the NPFPMS.CFG file by using the
  1498. command:  FIELDS <data>
  1499. <data> is a list of 16 numbers, 4 for each BBS type, seperated by commas.
  1500. The order is:  OTHERBBS  FBBBBS  NNABBS  NPFPMS
  1501. In each group of 4, the first is the TO field, the second is the @BBS field,
  1502. the third is the FROM field, and the fifth is the SUBJECT field.
  1503. i.e.  FIELDS 4,5,6,8,4,5,6,8,4,5,6,8,4,5,6,8  (The defaults) You must specify
  1504. all 16 numbers, even if your are only changing one set of four.
  1505.  
  1506. If the PMS extracts a field incorrectly, the message header, as displayed on
  1507. the PMS, will be incorrect. This will not cause any real problems, as AutoRead
  1508. messages are given the status ZN and are treated as personal messages. They
  1509. cannot be read by anyone other than the PMS SysOp, and will not be included in
  1510. any forwarding sessions, or appear in listings to other users of the PMS.
  1511. (Unless THIRDPARTY is set to ON)
  1512.  
  1513.  
  1514. General.
  1515. --------
  1516. AUTOREADCMD  R or V ?
  1517. V (Verbose read) will retain all the routing lines, whilst R (Read) will not.
  1518. The routing information lines contains the senders Home BBS. If you use the SR
  1519. (or SC) command on a message that does not have routing information, the PMS
  1520. will check its WP file and may, or may not, obtain the senders correct Home BBS
  1521. from there. The routing information is more reliable, but can involve
  1522. downloading a large amount of extra text. This might be seen as anti-social on
  1523. a busy frequency.
  1524. Note: This does not apply when AutoReading from a FBB BBS, where messages are
  1525. read in compressed format, which includes the routing information.
  1526.  
  1527. AUTOROUTE-A contains the connect path to your NTSBBS for type A AutoList
  1528. AUTOROUTE-B contains the connect path to your NTSBBS for type B AutoList
  1529. e.g.  AUTOROUTE-A G1NNA-1:GB7ESX    or    AUTOROUTE-A GB7DDX
  1530.       
  1531. You can cross connect via a KA node by using the 'X' option. e.g.       
  1532.       AUTOROUTE-A KEPAC3:X GB7DUG
  1533.  
  1534. (See 'Syntax of connect paths' for a full description of connect paths)
  1535.  
  1536.  
  1537. AUTOPROMPT-A contains the prompt the NTSBBS issues when it has finished
  1538. sending text. The prompt will normally be something like:   GB7ESX BBS >
  1539. Some BBS's (FBB) can prefix the prompt with a (variable) port number, and some
  1540. include the time (obviously variable!). So, what the PMS looks for is a line
  1541. ending with a > character, and including the specified prompt within the line.
  1542. If AUTOPROMPT-A is set (for example) to  GB7ESX BBS  then the PMS will accept
  1543. 2:GB7ESX BBS >   or   GB7ESX BBS 10:35 >   or just   GB7ESX BBS>
  1544. In the (unlikely) event of the prompt actually appearing in a message header or
  1545. content, then the AutoList/Read function will terminate prematurely, so make
  1546. the AUTOPROMPT-A as specific as possible.
  1547. (The above also applies to AUTOPROMPT-B)
  1548.  
  1549. IT IS MOST IMPORTANT TO GET THE PROMPT CORRECT.
  1550. It is the only way the PMS knows it has finished receiving text from the BBS.
  1551. If the prompt is incorrect, the PMS will just 'sit and wait' until your
  1552. connection times out, and the BBS disconnects you.
  1553.  
  1554. Set the times to carry out the AutoList function in the npfpms.cfg file.
  1555. e.g.  AUTOLISTTIME-A hh:mm hh:mm  etc.....
  1556.       AUTOLISTTIME-B hh:mm hh:mm  etc.....
  1557.  
  1558. The AutoList and AutoRead functions have been tested with NNA BBS and
  1559. FBB BBS. I do not know if they will work correctly with other types of BBS
  1560. software. I would be pleased to hear if they do, or do not!
  1561.  
  1562. Note:  If your NTSBBS has a pause option, then it *MUST* be set to OFF, or
  1563.        AutoList and AutoRead will not function correctly.
  1564.  
  1565.  
  1566. Automatic AutoList functions are disabled if no times are set.
  1567. The reception and processing of FBB Unproto broadcasts can be disabled by
  1568. setting UPLISTSIZE to 0 (zero).
  1569.  
  1570.  
  1571. The two AutoList functions can run alongside each other, but normally one or
  1572. the other will be disabled.
  1573. (You could, for instance, run the AutoList type A function with a NNA BBS, and
  1574. the AutoList type B function with a different FBB BBS. Now, whether this is a
  1575. good idear or not is another question....) 
  1576.  
  1577. Note:
  1578. Function keys F6, F8 & F9 have been re-programmed in PMS version 2.17 to
  1579. accomodate the new funtions.
  1580.  
  1581. -------------------------------------------------------------------------------
  1582. Monitor port mask options.
  1583.  
  1584. The monitor mask controls which radio ports are monitored, and what types of
  1585. frames are displayed. The PMS can monitor BPQ radio ports 1 to 12
  1586. The mask number is a 4 digit hexadecimal number.
  1587.  
  1588. The first digit is the frame mask, which sets the types of frames monitored.
  1589. The value is a hex number from 0 to F. It is a bit field where:
  1590. Bit 1 enables the display of NODES broadcasts.
  1591. Bit 2 enables the display of supervisory frames.
  1592. Bit 3 enables the display of NetRom frames.
  1593. Bit 4 is not used, and is always 0.
  1594. Normal frames containing data (text) are always displayed.
  1595. The default is 7 (bits 1-3 set) which means monitor all types of frames.
  1596.  
  1597. The last 3 digits of the number are the BPQ radio port mask.
  1598. The value is a 3 digit hex number from 000 to FFF. It is a bit field where:
  1599. Bit 1 enables monitoring of radio port 1
  1600. Bit 2 enables monitoring of radio port 2
  1601.  (...through to...)
  1602. Bit 12 enables monitoring of radio port 12
  1603. The default value of FFF (hex) means monitor all ports.
  1604.  
  1605. The full mask value will normally be 7FFF hex. The current value is displayed
  1606. on the lower status line as Mask-xxxx and can be changed with the F3 key.
  1607.  
  1608. -------------------------------------------------------------------------------
  1609. The system text editor.
  1610.  
  1611. The editor is not intended to be a full-blown word processor!
  1612. It should be sufficient for its purpose.
  1613. Note: All control codes, other than 13 (CR) and 26 (EOF), will be removed from
  1614. a text file loaded into the editor.
  1615.  
  1616. Whilst in the editor you can use the normal edit keys;
  1617. Insert, Delete, Backspace, 'Arrow' keys, Home, End, Page up, Page Down,
  1618. and Ctrl+(edit key) to move around the text. Automatic word wrap is used.
  1619.  
  1620. ^Y   Delete an entire line.
  1621. ^U   Re-insert the last line deleted, at the current line position.
  1622. ^P   Allow the next character to be a control code.
  1623.  
  1624. ^KA  Copy a marked block to the current cursor position.
  1625. ^KB  Mark the start of a block.
  1626. ^KH  Clear the markers.
  1627. ^KK  Mark the end of a block.
  1628. ^KP  Print a marked block. If no markers are set, then nothing is printed.
  1629. ^KQ  Quit the editor without saving the file.
  1630. ^KR  Read another file into the editor, at the current cursor position.
  1631. ^KS  Save the file and stay in the editor.
  1632. ^KV  Move a marked block to the current cursor position.
  1633. ^KW  Append a marked block to a file.
  1634. ^KX  Save the file, then quit the editor.
  1635. ^KY  Delete a (small) marked block.
  1636.  
  1637. <Enter>     Split the line, or create a new blank line.
  1638. <Tab>       Inserts spaces to move the cursor to the next Tab position.
  1639.  
  1640. ^ indicates a control key sequence. ^KR is <Ctrl>K followed by R
  1641.  
  1642. Note:
  1643.      The block markers may be incorrect if a word wrap occurs at the beginning
  1644.      or end of the marked block.
  1645.  
  1646. Editing a PMS message file.  (S/EM)
  1647. If you are editing a message file, do not alter or delete the R: routing lines,
  1648. as these are used by the forwarding system.
  1649.  
  1650. If you wish to read the contents of another PMS message into the editor, then
  1651. you can refer to the PMS message in shortform. Assuming the message number to
  1652. read is 1234, then enter #1234 as the filename to read and the name will be
  1653. converted to MAIL\MSG01234.msg
  1654. If you actually need to read in a real file called #1234 then include the full
  1655. path in the filename.  e.g. \TEXT\#1234
  1656.  
  1657. -------------------------------------------------------------------------------
  1658. 7Plus files.
  1659.  
  1660. The PMS can automatically convert 7Plus files received as messages into
  1661. separate 7Plus files using the original file name extracted from the 7Plus
  1662. header.  e.g. If a multi-part 7Plus program has been sent to the PMS as message
  1663. numbers 201, 202 and 203 then enter the command:  D7 201 202 203
  1664. D7 is the command, followed by the relevant message numbers.
  1665. It will create 3 files in the 7PLUS\ sub-directory called xxx.P01 xxx.P02  and
  1666. xxx.P03 (The xxx being the original filename)
  1667.  
  1668. Note: The PMS does not actually decode the files.  It converts message files
  1669. into 7Plus files ready for decoding with 7PLUS.EXE
  1670.  
  1671. (7PLUS 2.02 is copyright (C) DG1BBQ)
  1672.  
  1673. -------------------------------------------------------------------------------
  1674. User variables.
  1675.  
  1676. The following variables may be used in SCRIPT files, and in the multi-line
  1677. configuration commands in the npfpms.cfg file.
  1678. The variable will be converted to the appropriate text when transmitted.
  1679. Any $x not listed below will be removed from the text.
  1680. Note: The case of the character is significant!
  1681.  
  1682. $$        The $ character itself.
  1683. $A        The day of the week.
  1684. $B        Bell.  Adds a ASCII code 7 to the text.
  1685. $C        Callsign of the user currently connected.
  1686. $D        USA Date. MM-DD-YYYY      e.g. 09-26-1992
  1687. $d        Date.     DD month        e.g. 26 Sep
  1688. $E        Date.     DD-MM-YY        e.g. 26-09-92
  1689. $e        Date.     DD-MM-YYYY      e.g. 26-09-1992
  1690. $F        Lowest message number.
  1691. $g        Date.     DD month YYYY   e.g. 26 Sept 1992
  1692. $I        SysOp's name.
  1693. $J        A New Line  (CR - ASCII 13)
  1694. $K        The currently connected users total number of log-on's.
  1695. $L        Highest message number.
  1696. $l        Users message pointer.
  1697. $M        "morning/afternoon/evening"  (Depending on time of day)
  1698. $N        Number of active messages.
  1699. $n        Number of unread messages for currently connected user.
  1700. $O        PMS callsign.
  1701. $o        The local NTSBBS callsign.
  1702. $P        The PMS channel number.
  1703. $S        Time signature.  e.g. gmt
  1704. $T        Current time.  hh:mm
  1705. $t        Current time.  hh:mm:ss
  1706. $U        Same as $X
  1707. $V        Software version.
  1708. $W        The currently connected users name.
  1709. $X        The currently connected users last log-on date. (dd-month-yyyy)
  1710. $x        The currently connected users last log-on date. (dd-month)
  1711. $Y        The currently connected users last log-on time. (hh:mm)
  1712.  
  1713. S0 to $9 are reserved for internal use. Do not use!
  1714. Any $x variable not listed above will be removed from the text.
  1715. Note:
  1716. The date separator depends on the setting of DATESEP in the npfpms.cfg file
  1717. It defaults to a '-'
  1718.  
  1719. ===============================================================================
  1720. DESQview interface.
  1721.  
  1722. NPFPMS is a 'DESQview aware' program. It can make the required calls to the
  1723. DESQview API to interface correctly with DV. It can also give up it timeslice
  1724. when just its idling, waiting for input.
  1725.  
  1726. The PMS command line switch /V has the following options:
  1727. /V0  Disable all DV calls.
  1728. /V1  Enable 'DV critical' calls.
  1729. /V2  Enable 'release timeslice' calls.
  1730. /V3  Enable both. (Default)
  1731. If the PMS detects DESQview has been loaded it will enable all DV calls, unless
  1732. a /V option has been used on the command line. If DESQview has not been loaded
  1733. then all DV calls are disabled regardless of any /V option.
  1734.  
  1735.  
  1736. Suggested set-up for DESQview V2.3+ and a 386/486 PC
  1737.  
  1738. The PMS *should* work under DESQview on a 286, but its not been tested.
  1739. The BIOS must be dated 01/10/86 or later. The DESQview version must be 2.3 or
  1740. later.
  1741.  
  1742.  
  1743.   Program Name............: NPFPMS
  1744.   Keys to Use on Open Menu: PM                         Memory Size (in K): 590
  1745.  ──────────────────────────────────────────────────────────────────────────────
  1746.   Program...: C:\PMS\PMSCODE.EXE
  1747.   Parameters: /DX
  1748.   Directory.: C:\PMS\
  1749.  ──────────────────────────────────────────────────────────────────────────────
  1750.   Options:
  1751.                Writes text directly to screen.......: [N]
  1752.                Displays graphics information........: [N]
  1753.                Virtualize text/graphics (Y,N,T).....: [Y]
  1754.                Uses serial ports (Y,N,1,2)..........: [N]
  1755.                Requires floppy diskette.............: [N]
  1756.  
  1757.  
  1758.  
  1759.                       Change a Program Advanced Options
  1760.  
  1761.  System Memory (in K).......:   0   Maximum Program Memory Size (in K)..: 630
  1762.  
  1763.  Script Buffer Size.........:   0   Maximum Expanded Memory Size (in K):
  1764.  
  1765.  Text Pages: 1  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF
  1766.  ──────────────────────────────────────────────────────────────────────────────
  1767.   Window Position:
  1768.     Maximum Height:  25       Starting Height:  25       Starting Row...:  0
  1769.     Maximum Width.:  80       Starting Width.:  80       Starting Column:  0
  1770.  ──────────────────────────────────────────────────────────────────────────────
  1771.  
  1772.   Close on exit (Y,N,blank)......: [N]  Uses its own colors..............: [Y]
  1773.   Allow Close Window command.....: [N]  Runs in background (Y,N,blank)...: [Y]
  1774.   Uses math coprocessor..........: [N]  Keyboard conflict (0-F)..........: [0]
  1775.   Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  1776.   Can be swapped out (Y,N,blank).: [ ]  Protection level (0-3)...........: [2]
  1777.  
  1778.  
  1779. Notes:
  1780. 'Uses serial ports' is set to [N] as the PMS program does not use the serial
  1781. ports directly. Control of the serial ports is by the BPQcode, which must be
  1782. loaded BEFORE DESQview.
  1783.  
  1784. It *may* be possible to reduce the 'Memory Size' down from the 590K suggested
  1785. if the buffer sizes are kept small. Should the PMS stop with an ERROR 7,
  1786. or DESQview just aborts the PMS, it is most likely running out of memory!
  1787. An EXCEPTION 13 error can be generated by (Q)EMM386.SYS if the PMS does not
  1788. have enough memory to run one of its sub-programs (i.e. message compression).
  1789. *THE* most common reason for the PMS to fail to work correctly under DESQview
  1790. is lack of allocated memory!
  1791.  
  1792. The PMS will make the relevant calls to DESQview to prevent time-critical
  1793. events being interrupted.
  1794.  
  1795. ===============================================================================
  1796. USER.DOC file
  1797.  
  1798. Please note that the format of the user.doc file is important as it is used by
  1799. the help system. If you edit the file do not remove the blank lines between
  1800. entries, or the leading spaces.
  1801. You may edit the actual text, but do not change the way it is set out.
  1802.  
  1803. -------------------------------------------------------------------------------
  1804. Log file.
  1805.  
  1806. The log file records the activity of the PMS. Most automatic functions and
  1807. errors are recorded in the system log. The log can be browsed/edited by
  1808. pressing the F6 key to load the log file into the editor. You must not delete
  1809. the log file, or edit it from 'outside' whilst the PMS is running!
  1810.  
  1811. -------------------------------------------------------------------------------
  1812.  
  1813. When a new message arrives for the SysOp a series of 5 pips will sound. The
  1814. same signal is sounded (as a reminder) if a Msg for:  beacon is transmitted
  1815. which includes the SysOp's callsign. The Scroll Lock LED on the keyboard will
  1816. also flash to indicate a new message has arrived. Reading ANY message will
  1817. cancel the flash.
  1818.  
  1819. -------------------------------------------------------------------------------
  1820. BID's and MID's.
  1821.  
  1822. Bulletin ID's are stored in a file called SYS\bids.rec
  1823. This file should be 'pruned' occasionally (every few months?) to remove oldest
  1824. entries. The larger the file grows, the slower the duplicate checking will be.
  1825. You can use the system editor for this, as the file is in ascii format.
  1826. The <Shift>F6 key will load the bids.rec file into the editor.
  1827.  
  1828. -------------------------------------------------------------------------------
  1829. Testing the PMS locally.
  1830.  
  1831. You can connect from one PMS window to another to test the system.
  1832. e.g.
  1833. Select window 0
  1834. Press F10 to connect to the BPQ switch.
  1835. Type C G8NPF-3   (or whatever the PMS's callsign is)
  1836. (Enter your security characters, if appropriate).
  1837. You will now be connected to the PMS, as if you had connected 'over the air'
  1838.  
  1839.  
  1840. ===============================================================================
  1841. Restricting the range of messages Listed and Read.
  1842. The 'A' and 'R' parameters.
  1843.  
  1844. In order to speed up searches, most list commands only operate on a restricted
  1845. range of messages. The basic L (List) command only scans messages added since
  1846. the user last did a List. Most other List and Read commands only scan messages
  1847. added since the users last log-on. To force these commands to search ALL the
  1848. messages on the system, append an A to the command.
  1849. e.g.    L A
  1850.         L> OS2 A
  1851.         L< G8NPF A
  1852.  
  1853. Some commands normally search the entire message base by default. To restrict
  1854. these commands to searching 'new' messages only, append an R to the command.
  1855. e.g.    LX R
  1856.         LM R
  1857.         
  1858. If you have a large number of messages in the message base, then some List
  1859. commands can still result in very long lists.
  1860. (i.e. A new user logs on and types L, or the SysOp uses the LX command).
  1861. You can set a limit to the number of messages listed by any of the List
  1862. commands, with the MAXLIST setting in the npfpms.cfg file. MAXLIST defaults to
  1863. 50. If recent messages have been killed or deleted, then you may get somewhat
  1864. less than the expected maximum.
  1865.  
  1866.  
  1867. Note:
  1868. A users message pointers are updated automatically when the user disconnects
  1869. with the (B)ye (or Q) command .
  1870. To update your (the SysOp's) message pointers, just type B at a command line.
  1871.  
  1872. -------------------------------------------------------------------------------
  1873.  
  1874. Misc. notes regarding the BPQCFG.
  1875.  
  1876. The PMS callsign is read from the BBSCALL entry in the BPQCFG.BIN file.
  1877.  
  1878. The PMS "Message for:" beacon will be transmitted on all BPQ ports that have an
  1879. UNPROTO path set in the BPQCFG file.
  1880.  
  1881. The BPQ directory specified by the BPQDIR option must contain the file
  1882. BPQCFG.BIN (read by the PMS on start-up).
  1883.  
  1884. There is no need to specify any TNCPORT's for Host Mode operation, and you do
  1885. not need to load the BPQHTNC2 driver.
  1886.  
  1887. -------------------------------------------------------------------------------
  1888. Automatically changing the @BBS field on incoming messages.
  1889.  
  1890. The file CONFIG\change.bbs holds a list of @BBS fields to be replaced and the
  1891. revised field.
  1892.  
  1893. i.e.
  1894. ESX #ESSEX              will replace @ESX with @#ESSEX
  1895. GB7NNA GB7ESX           will replace @GB7NNA with @GB7ESX
  1896. GB GBR.EU               will replace @GB with @GBR.EU
  1897.  
  1898.  
  1899. -------------------------------------------------------------------------------
  1900. Message on hold.
  1901.  
  1902. There is a facility to place 'on hold' all incoming messages addressed TO or
  1903. FROM a specific callsign, all messages addressed @ a particular BBS, or all
  1904. messages sent by a particular station regardless of the TO or FROM fields.
  1905.  
  1906. Enter a list of callsign's to be held in the file  CONFIG\hold.lst
  1907. One callsign per line. SSID's are ignored.
  1908.  
  1909. i.e.
  1910. > G9AAA
  1911. < G9AAA
  1912. < G9BBB
  1913. @ GB9XXX
  1914. B GB9ZZZ
  1915.  
  1916. Will hold all messages addressed TO or FROM G9AAA, all messages FROM G9BBB,
  1917. all messages addressed to stations @ GB9XXX, and ALL messages sent by the
  1918. station GB9ZZZ regardless of the TO or FROM fields.
  1919.  
  1920. Messages are flagged as as type H. (PH BH)  Only the SysOp can list or read
  1921. these messages. The SysOp can hold a message manually with the HM command,
  1922. and clear it with the UH command. The LH command will list all held messages.
  1923.  
  1924. -------------------------------------------------------------------------------
  1925. 3rd party message restrictions.
  1926.  
  1927. By default, the PMS will not accept 3rd party messages from anyone but the PMS
  1928. SysOp. Also, a normal user cannot list or read 3rd party messages.
  1929. This complies with the current RA rules.
  1930. (The PMS SysOp can always access ALL messages)
  1931.  
  1932. If you wish to allow 3rd party access to ALL users (NOV?), then set
  1933. THIRDPARTY to 2, in the npfpms.cfg file.
  1934.  
  1935. If you wish to allow limited 3rd party access to a few 'trusted' users, then
  1936. set THIRDPARTY to 1, and set the individual users 'S' and 'R' access flags as
  1937. appropriate.
  1938.  
  1939. From version 2.17, compressed messages forwarded to the PMS are also checked.
  1940. Messages from a FBB type BBS are checked as they are offered, and 3rd party
  1941. messages are rejected before they are sent.
  1942. With NNA type BBS's its not possible to reject the messages before they are
  1943. sent, so they are checked afterwards and any 3rd party messages are changed to
  1944. type Z (the same type as AutoRead messages).
  1945. This prevents any other user seeing the messages on the PMS.
  1946. If you have given the NTSBBS 3rd party access, then all messages are accepted.
  1947.  
  1948. Note:
  1949. If you have arranged for your NTSBBS to forward certain types of bulletins to
  1950. your PMS, then you must give the BBS 3rd party access by setting the 'S'
  1951. access flag, and set THIRDPARTY to 1 (or 2)
  1952.  
  1953.  
  1954. By default, the PMS will only forward out messages addressed FROM the SysOp.
  1955. If you wish the PMS to forward 3rd party messages, set FWDLEVEL to 2, in the
  1956. npfpms.cfg file.
  1957.  
  1958. -------------------------------------------------------------------------------
  1959. DOS * commands.
  1960.  
  1961. There is LIMITED support for DOS commands entered at the pms> prompt.
  1962. Commands must be pre-fixed with a * character.  i.e.  *DIR /W
  1963. You should restrict usage to 'simple' DOS commands, and avoid 'advanced'
  1964. commands that may corrupt the memory/environment in use by the PMS.
  1965.  
  1966. Be VERY careful with DOS commands as it is possible to do things that may
  1967. corrupt the PMS code, hang the system, or change files the PMS is using.
  1968.  
  1969. If a DOS command prompts for input, you will NOT see the prompt!
  1970. If the command then looks for keyboard input it will receive a dummy <Enter>
  1971. keystroke, as the keyboard buffer is pre-loaded with a few ASCII 13's.
  1972. The command *TIME (on its own) would, for instance, prompt for the new time and
  1973. expect to read the reply from the keyboard buffer. It will just get a dummy
  1974. <Enter> and the time would not be changed. Entering *TIME 20:15 will execute ok
  1975. as the required input is already there and the time will be changed.
  1976.  
  1977. However, if the DOS command flushes the keyboard buffer prior to looking for
  1978. input (as the DIR command can do, if the listing is a long one) then it will
  1979. just wait for you to press a real key.
  1980.  
  1981. In general, try to avoid using commands that may prompt for input.
  1982. If you get stuck, Ctrl/C or Ctrl/Break will often terminate a DOS command.
  1983.  
  1984. Please note that whilst an external DOS command is executing, *ALL* the PMS
  1985. windows are frozen. If you use a DOS command that takes a long time to execute,
  1986. or waits for keyboard input, the PMS will be prevented from functioning.
  1987.  
  1988.  
  1989. Once a hour, on the hour, the PMS will call an external batch file. This must
  1990. be in the \PMS\CONFIG directory, and called "external.bat"
  1991. The batch file can contain any commands normally valid in a batch file, and
  1992. can run EXE or COM files and/or call other batch files. Bear in mind that
  1993. while the file is executing the PMS 'multi-tasking' is frozen, so only run
  1994. quick programs that DO NOT pause and wait for keyboard input!
  1995.  
  1996.  
  1997. -------------------------------------------------------------------------------
  1998. Password protection for users and forwarding sessions.
  1999.  
  2000. The pms supports 'NNA style' password protection for both normal users and for
  2001. PMS<>BBS forwarding sessions. To enable the latter, include a V in the pms SID.
  2002.  
  2003. If a user is allowed Remote SysOp access ('A' access flag set), then SysOp
  2004. status is granted automatically when the PMS receives a valid password.
  2005.  
  2006. Before a user can have password facilities he must first be issued with a
  2007. password matrix like the one below. Each users matrix will be different.
  2008. A password matrix can be generated using the external program PASSWORD.EXE,
  2009. entering the command as:  PASSWORD <callsign>
  2010. This will create a matrix for the specified callsign called xxxxxx.mat
  2011. where xxxxxx is the callsign. This matrix file should then be placed in the PMS
  2012. CONFIG directory, and a copy given to the user.
  2013.  
  2014. Example matrix.
  2015.                   0 1 2 3 4 5 6 7
  2016.                         
  2017.               0   A b F $ 7 : j u
  2018.               1   1 H J & : F S H
  2019.               2   H F R T & 5 4 c
  2020.               3   b f $ S ! J N B
  2021.               4   J k y f % 5 2 0
  2022.               5   + G D 3 $ y f 5
  2023.               6   = g h E x v \ j
  2024.               7   R p * X ; Y C d
  2025.  
  2026. The matrix is numbered 0 - 7 down (the first of the double numbers) and 0 - 7
  2027. across (the second of the double numbers).
  2028.  
  2029. The user logs onto the PMS in the normal way where they can read mail, download
  2030. files etc. However, before they can SEND or KILL a message they will have to
  2031. enter a @ character at the prompt and wait. The PMS will return 3 pairs of
  2032. numbers.
  2033.  
  2034. They must then check their personal password matrix and enter the correct
  2035. characters without spaces. The password is case sensitive so it must be entered
  2036. exactly as it's laid out in the matrix.
  2037.  
  2038. In the above example matrix, if the PMS sent 21 54 27 the user would enter F$c
  2039.  
  2040. The first pair of numbers is 21   -  2 down, 1 across  = F
  2041. The second pair of numbers is 54  -  5 down, 4 across  = $
  2042. The third pair of numbers is 27   -  2 down, 7 across  = c 
  2043.  
  2044. There must be no spaces and upper and lower case letters must be entered just
  2045. as they are in the matrix.
  2046.  
  2047. No acknowledgement is given to say if the password was entered correctly or not.
  2048. Incorrect replies will be ignored so they can send @ and answer as many times
  2049. as they like. This adds further security to the password.
  2050.  
  2051. If the password has not been correctly entered, the user will receive the
  2052. message "This message will be held" if they try to send a message. If this
  2053. happens they can enter * to cancel the message and follow the above
  2054. instructions again (or carry on and have the message held).
  2055.  
  2056.  
  2057. For automatic forwarding sessions both the PMS and the BBS you are forwarding
  2058. to/from must have the same matrix. If both stations have a V in the SID them
  2059. the password is sent automatically. An incorrect password or a missing matrix
  2060. file will result in a disconnect! If you wish to use your BBS's alias, rather
  2061. than its real callsign (i.e. xxxBBS rather than GB7xxx) then you will need a
  2062. duplicate matrix for the alias. (Just copy the matrix GB7xxx.MAT to xxxBBS.MAT)
  2063.  
  2064.  
  2065. The password protection operates as follows:-
  2066. Assuming you always have a V in your pms SID...
  2067.  
  2068. Manual incoming connections.
  2069. ----------------------------
  2070. 1.  A 'normal' user connects, for whom you DON'T have a password matrix stored:
  2071.     No password matrix means password protection is not used.
  2072.     The @ command has no effect. It is just ignored.
  2073.  
  2074. 2.  A 'normal' user connects, for whom you DO have a password matrix stored:
  2075.     Valid password matrix means password protection is used.
  2076.     If the user sends a valid password (with the @ command), then the user can
  2077.     send messages normally, otherwise any messages sent are 'held for SysOp's
  2078.     attention. An incorrect password response is simply ignored.
  2079.  
  2080.  
  2081. Automatic incoming connections.
  2082. -------------------------------
  2083. 1.  A bbs user connects, for whom you DON'T have a password matrix stored:
  2084.     The bbs user sends his SID [..-BFHLM$]  (No V)
  2085.     No V in the incoming SID means no request for a password is made.
  2086.     Normal forwarding takes place.
  2087.  
  2088. 2.  A bbs user connects, for whom you DON'T have a password matrix stored:
  2089.     The bbs user sends his SID [..-BFHLMV$]  (with a V)
  2090.     A V in the incoming SID, with no valid password matrix for the user, means
  2091.     the user is immediately disconnected.
  2092.  
  2093. 3.  A bbs user connects, for whom you DO have a password matrix stored:
  2094.     The bbs user sends his SID  [..-BFHLM$]    (No V)
  2095.     No V in the incoming SID means no request for a password is made.
  2096.     Normal forwarding takes place, but the valid password matrix means that any
  2097.     incoming messages are 'held for SysOp's attention.
  2098.  
  2099. 4.  A bbs user connects, for whom you DO have a password matrix stored:
  2100.     The bbs user sends his SID  [..-BFHLMV$]   (With a V)
  2101.     A V in the incoming SID causes a password to be requested automatically.
  2102.     If a valid password is received, the user can forward messages normally.
  2103.     If a invalid password is received then the user is disconnected.
  2104.  
  2105.  
  2106. A normal user is a user who does not send a SID when connecting.
  2107. A bbs user is a user using PMS/BBS software that sends a SID [....] when it
  2108. connects to another station in automatic mode.
  2109.  
  2110. The password system also operates when a user tries to KILL messages.
  2111.  
  2112. So, if a pirate used the callsign of someone who had arranged for a password at
  2113. the BBS/PMS, the best the pirate could achieve is to send a message that was
  2114. placed 'on hold', and would not be forwarded on anywhere until the SysOp
  2115. released it. If the contents were 'dubious' them the SysOp would contact the
  2116. supposed sender first, to verify if the message was genuine.
  2117.  
  2118. To disable the automatic 'BBS' password verification, remove the V from the
  2119. PMS's SID and remove the appropriate password matrix file.
  2120. To disable a 'normal users' password verification, remove the users password
  2121. matrix file.
  2122.  
  2123. Remember, a matrix is created at random, so if you delete a users matrix, and
  2124. then generate a matrix for the user again, the new matrix will be different
  2125. from the old one. You would then need to send the new matrix to the user.
  2126. If you only wish to remove a matrix file temporarily, just rename xxxxx.MAT to,
  2127. say, xxxxx.OLD  You can then re-instate it easily, without having to generate a
  2128. new matrix.
  2129.  
  2130. ------------------------------------------------------------------------------
  2131. Importing messages from disk file.
  2132.  
  2133. The PMS can import messages from a disk file (plain text, NNA BBS format)
  2134. The command is: IMPORT (drv:)filename.ext
  2135. (Where 'filename.ext' is the name of the file to import).
  2136. Messages are read from the file as if they were being forwarded to the PMS. The
  2137. BID's checking works as normal, so the PMS will not import duplicate messages.
  2138.  
  2139.  
  2140. Exporting messages to a disk file.
  2141.  
  2142. Exporting messages to a file is an extension of the forwarding system.
  2143. EXPORT is a 'special callsign' which is used to create the export file. 
  2144. To manually create an export file, use FD EXPORT (options)  The options are the
  2145. same as those normally used with the FD command. The 'forwarded' messages are
  2146. written to a file call \PMS\export.bbs
  2147. This file can then be copied to a floppy disk with:  *COPY EXPORT.BBS A:
  2148.  
  2149. An export file can be created automatically by including an entry in the
  2150. fwdfile.lst using the 'special callsign' EXPORT (options) i.e.
  2151. EXPORT @GB7ESX >ALL
  2152. (For a list of the available options, see the FD command).
  2153.  
  2154. Normally, once a message has been exported to the export file it is marked as
  2155. such, and will not be exported again. You can force the PMS to export messages
  2156. a second time by placing a /D at the end of the EXPORT command. That will
  2157. inhibit the duplicate checking.
  2158.  
  2159. ------------------------------------------------------------------------------
  2160. Deleting messages 'Locked by another channel'.
  2161.  
  2162. If the PMS code aborts while a message is being sent, you may end up with a
  2163. zero length message which shows in the listings something like:
  2164. Msg#  TS  Size  Date   (etc...)
  2165. 1234  Cn     0  28-Jul (etc...)
  2166.  
  2167. (The Cn indicates the message was coming from channel n)
  2168. Attempting to delete the message with the DL command may produce a response
  2169. like 'Locked by another channel?'
  2170.  
  2171. To delete the message, first use the 'Mark Normal' command.
  2172. Assuming message number 1234, type:
  2173. MN 1234
  2174. Then you can delete it as normal.
  2175.  
  2176. WARNING:
  2177. Only use this method to delete 'crashed' messages.
  2178. DO NOT use it on a message that is actually being entered on another channel!
  2179.  
  2180. ------------------------------------------------------------------------------
  2181. Automatic connection to other nodes. (When forwarding etc.)
  2182.  
  2183. Different types of nodes can produce a variety of 'connect' text. Net-Rom & BPQ
  2184. nodes, when connected to at Level 4, using the real callsign of the node,
  2185. normally just send 'Connected to xxxxx' or 'Failure with xxxxx' This is the
  2186. normal type of reply the PMS expects, to determine if the connection has been
  2187. successful or not. However, if connections are made at level 2, using the 
  2188. node's alias, or the node is a KA Node, then the text can be several lines
  2189. long, and quite varied!
  2190.  
  2191. To allow for this you can specify up to 5 text strings (in the npfpms.cfg file)
  2192. for determining if a connection to a node has succeeded or failed, with the
  2193. commands:  NODECONN <text>  and  NODEFAIL <text>
  2194. See the settings in the sample npfpms.cfg file.
  2195.  
  2196. When the PMS connects to a node, it will check all the text strings specified,
  2197. looking for a match within the nodes reply text, to determine if the connection
  2198. was successful or not. Any node reply text not containing any of the specified
  2199. text strings will be ignored.
  2200.  
  2201. e.g. If you set:
  2202. NODEFAIL  FAILURE WITH
  2203. NODEFAIL  BUSY FROM
  2204. NODECONN  CONNECTED TO
  2205. NODECONN  LINK MADE
  2206.  
  2207. Then, if the PMS receives any text from the node containing 'Failure with' or
  2208. 'Busy from' it will assume the connect failed. If is sees any text containing
  2209. 'Connected to' or 'Link made' it will assume the connection succeeded.
  2210.  
  2211. You can specify up to ten NODECONN strings, and up to ten NODEFAIL strings.
  2212. Any more will be ignored.
  2213.  
  2214. Note: The case of the received text is not important. Lower case text is
  2215. converted to upper case.
  2216.  
  2217. ------------------------------------------------------------------------------
  2218. Use of a Virtual Disk (RAM disk).
  2219.  
  2220. The PMS can make use of a virtual disk (or a different hard disk) for its
  2221. temporary files. Using a ram disk will speed up bulk forwarding compression
  2222. and de-compression, and other operations that create temporary files.
  2223. You specify the virtual disk using the TEMPDRIVE command in the npfpms.cfg file
  2224. as TEMPDRIVE drv:(\path)
  2225. i.e.
  2226.     TEMPDRIVE  E:\          To use the root directory of drive E
  2227. or
  2228.     TEMPDRIVE  G:\TEMP\     To use the sub-directory \TEMP of drive G
  2229.  
  2230. A virtual disk drive MUST exist. If you specify a SINGLE sub-directory, then
  2231. the PMS will attempt to create it, if it does not exist. The PMS cannot create
  2232. multiple non-existent directories.
  2233.  
  2234. To create a 500K virtual disk in extended memory, insert an entry into your
  2235. config.sys file something like:
  2236. DEVICE=C:\DOS\VDISK.SYS 500 /E
  2237. The exact syntax may vary depending on your OS.
  2238.  
  2239. ------------------------------------------------------------------------------
  2240. Alternative directory paths for files.
  2241.  
  2242. You can now specify alternative directories for download files area, the user
  2243. upload files area, and the message archive area, with the config options:
  2244. ARCHIVE <\path>      For archived messages.
  2245. FILES <\path>        For the download files area.
  2246. UPLOAD <\path>       For the user upload files area. Should be different to the
  2247.                      download files area.
  2248. <path> should be the FULL path to the directory, including the drive if
  2249. appropriate.  e.g. DIRFILE D:\MYAREA\PMSFILES\
  2250.  
  2251. The specified drive MUST exist. If you specify a SINGLE sub-directory, then
  2252. the PMS will attempt to create it, if it does not exist. The PMS cannot create
  2253. multiple non-existent directories.
  2254.  
  2255. If you specify a alternative FILES directory, you should COPY the file
  2256. \PMS\FILES\user.doc to the new files area. Do NOT erase it from the PMS\FILES\
  2257. directory!  It is still required by the user help system.
  2258.  
  2259. ------------------------------------------------------------------------------
  2260. Yapp protocol enhancements.
  2261.  
  2262. The PMS supports the YappC checksum protocol (as used by FBB).
  2263.  
  2264. 'Crash recovery' (Resume download)
  2265. If a users binary download fails part way through, the user can resume a file
  2266. transfer from the point of failure, rather than having to download the whole
  2267. file again. The user must also be running a version of Yapp that supports crash
  2268. recovery!
  2269.  
  2270. Crash recovery also operates when the SysOp is using the PMS in terminal mode
  2271. to download a binary file from another system that supports crash recovery.
  2272.  
  2273. *** Warning:  When the PMS prompts for a local filename for the file, if you
  2274. give the name of a file that already exists then the system will assume that
  2275. crash recovery is required, and the existing file will be appended to!
  2276. If the existing file was not an aborted part of the file you are currently
  2277. downloading, the resultant file will be invalid.
  2278.  
  2279. If the remote system does not support crash recovery, then it will abort the
  2280. transfer. In this case you will need to delete the existing (incomplete) file,
  2281. or specify a different local filename, and try again for a normal download.
  2282.  
  2283.  
  2284. ===============================================================================
  2285. EXTERNAL SUPPORT PROGRAMS
  2286. =========================
  2287.  
  2288. Re-numbering the PMS message base.
  2289. ----------------------------------
  2290. RENUMBER.EXE is an external program which will renumber the all PMS messages to
  2291. 101 upwards. It should be run from the PMS directory. The PMS *must* be closed
  2292. down before using this program!
  2293. You can specify a different starting number if required. i.e. RENUMBER 200
  2294.  
  2295. Don't re-number 'just for the sake of it'. Remember that message BID's are
  2296. generated from the message numbers, and if you re-number too often then the PMS
  2297. may produce a duplicate BID, which may then be refused if you attempt to
  2298. forward it to a BBS that has already received a message with the same BID.
  2299. Re-numbering should only be required if the message numbers approach the
  2300. highest valid number (99999) or a computer 'crash' has affected the numbering.
  2301.  
  2302.  
  2303. Pruning the message index file.
  2304. -------------------------------
  2305. PRUNEIDX.EXE is an external program that will prune out all deleted messages
  2306. from the message index file (SYS\msgindex.idx). It must be run from the PMS
  2307. directory. It should not normally be necessary to use this program, as the PMS
  2308. internal housekeeping will prune the index file automatically. It can, however,
  2309. be used if required.
  2310.  
  2311.  
  2312. Deleting a user from the user file.
  2313. -----------------------------------
  2314. DELUSER.EXE is an external program that can be used to delete a user from the
  2315. user file (namelog.sys). It must be run from the main PMS directory.
  2316. Typing:  DELUSER G9AAA  will list the entry for G9AAA, and then ask for
  2317. confirmation to to delete the entry. The original namelog.sys file is copied
  2318. to a backup file called namelog.old. Subsequent use of DELUSER will overwrite
  2319. any previous backup file.
  2320.  
  2321.  
  2322. Creating a user password matrix file.
  2323. -------------------------------------
  2324. PASSWORD.EXE is an external program which creates a password matrix for a
  2325. given callsign. Its operation is described in the section about passwords.
  2326.  
  2327.  
  2328. ===============================================================================
  2329. KNOWN PROBLEMS.
  2330. ===============
  2331.  
  2332. ANSI.SYS screen driver.
  2333. -----------------------
  2334. If you are using the ANSI driver, you may find that control codes in monitored
  2335. compressed text corrupt the screen display. Either remove ANSI.SYS from your
  2336. DOS config.sys file, or set SCREENFILTER 0-31 in the PMS config file to prevent
  2337. the PMS from displaying control codes.
  2338.  
  2339.  
  2340. File corruption.
  2341. ----------------
  2342. I couple of users have reported problems with file corruption (cross linked
  2343. clusters, invalid directory entries etc.)
  2344. In one case, the problem seemed to be due to a disk compression program. Some
  2345. disk compression drivers are know to be 'less than perfect'. The company
  2346. supplying the driver denied that there had ever been any problems, and then
  2347. produced an update to 'fix' the bugs they said did not exist!  Hmmm...
  2348.  
  2349. In another case the disk caching program SMARTDRIVE was being used, either as
  2350. part of a WINDOWS set-up, or with DOS. Removing Smartdrive cured all the file
  2351. corruption problems. Draw your own conclusions.
  2352.  
  2353. These problems may have been due to early versions of the programs involved.
  2354. There again.....
  2355.  
  2356.  
  2357. Mono systems.
  2358. -------------
  2359. If you have a problem running the PMS on a mono system (loss of inverted text,
  2360. no flashing text, unwanted underscored text), try setting DIRECT to ON. Also
  2361. try setting VDU to MONOVGA and pressing Ctrl-F7 to kill the colour.
  2362.  
  2363.  
  2364. Editor.
  2365. -------
  2366. There is a know bug in the editor, where it appears to loose a line of text.
  2367. The scrolling appears to get 'out of sync'. This only effects the screen
  2368. display, and not the actual editor buffer. No text is lost.
  2369.  
  2370. Pressing Page-Up Page-Down normally restores the screen.
  2371. I am trying to find the reason for this odd effect.
  2372.  
  2373.  
  2374.  
  2375. ==============================================================================
  2376. Registering the PMS.
  2377.  
  2378. If you decide to use the PMS code on a regular basis, and have not previously
  2379. registered, then the requested registration fee is 15.00 pounds.
  2380. You must state the callsign to be used with the PMS, and the full version
  2381. number of the version you are registering (i.e. G9ABC V2.20d). Also I would
  2382. appreciate knowing where you obtained the program from (optional, just for my
  2383. own information). You will then receive a registration number which will remove
  2384. the  ** Un-registered copy of NPFPMS **  line from outgoing messages, and you
  2385. will be added to the registered users list.
  2386.  
  2387. Cheques made out to 'E' Harrison please, not 'T ' (Ted is only a nickname!)
  2388.  
  2389. IF YOU WANT SUPPORT, THEN REGISTER!
  2390.  
  2391. Registrations recieved will be used to help with the cost of running my 24hr
  2392. multi-port node, which is used for forwarding BBS traffic and gives local
  2393. users access to the network. Your registration will be making a direct
  2394. contribution to packet radio.
  2395.  
  2396. Please note, the registration number only works with the callsign stated. If
  2397. the PMS is used with a different callsign, then the registration number has no
  2398. effect. Another user cannot use your registration number!
  2399.  
  2400. A registration form is included on the disk called REGISTER.FRM
  2401. -------------------------------------------------------------------------------
  2402.  
  2403. Appeal...
  2404.  
  2405. This collection of notes is badly in need of re-writing into a proper manual.
  2406. I am definitely not a 'manual-writer', so if anyone with the required skills
  2407. feels like volunteering to write a manual, I would be most happy to accept!
  2408.  
  2409. ==============================================================================
  2410.  
  2411. Special thanks to Beta-testers G6FBF, G6NHK, G8DZH and others, for their ideas
  2412. and suggestions.
  2413.  
  2414.  
  2415. Finally.......
  2416.  
  2417. PLEASE report any bugs or other problems you come across. I can't check
  2418. everything under all conditions, and welcome ANY feedback from users.
  2419. A lot of improvements have been as a result of suggestions and/or bug reports.
  2420. Thank you...
  2421.  
  2422. 73 Ted.
  2423. NTS       G8NPF@GB7ESX
  2424. AMPRNet   g8npf@g8npf.ampr.org  44.131.185.66
  2425. Internet  tedharrison@cix.compulink.co.uk
  2426.  
  2427.  
  2428.